Stuff++ Unlocked

Features extension script for eRepublik.com.

Installation

1. Install Tampermonkey.
2. Open Stuff++ unlocked url.
3. Tampermonkey page should appear. Install the script.
4. Refresh your eRepublik page.
5. That's all!

Donators badge

Players who support this project will have their avatars decorated with an animated border:

On a battlefield

On your feed and articles

Donation rewards

1M+ in currency	3M+ in currency	5M+ in currency
		Choose your custom border

How to donate?

1. Go to this profile.
2. Donate money.
3. Your border should appear to other Sutff++ unlocked users in max 1 day.

If you donate 5M+ in total you can write me a message specifying which border you choose.

Features

Basic

Basic feature inherited from Zordacz's old version.

Auto Traveller

• Automatically travels to the next region in the journey.

PowerSpin Auto-Spinner

• Display Power Spin Log.
• Auto spin until a money limit is reached,
• Or when we reach the 3rd Jackpot.
• Drastically improves spin animation speed allowing rolling again nearly instantly.

Daily Challenge reward collector

• Claim All button to collect all daily challenges.

What's new after an update

• After the script updates, a popup lists the new features and fixes since the version you last saw.
• The whole history is behind the Changelog link in the Stuff++ settings panel.

Feed comments scroll

Development

The script is built with Vite and vite-plugin-monkey. The userscript header is generated from vite.config.ts and the version from package.json.

Installation

Run npm ci to install dependencies.

Local development

1. Run npm start to start the development server on port 8124.
2. Open http://127.0.0.1:8124/__vite-plugin-monkey.install.user.js in your browser. Tampermonkey will offer to install [DEV] eRepublik Stuff++ Unlocked. You only need to do this once.
3. Disable the production script, so that only the DEV one is active.

The DEV script loads the code straight from the development server, so changes show up after refreshing the eRepublik page.

Production build

Run npm run build. The userscript is written to dist/index.user.js and copied to src/index.user.js, which is the URL existing installations update from.

Checks

• npm run typecheck - TypeScript
• npm run lint - ESLint
• npm test - Vitest unit tests
• npm run format:check - Prettier (npm run format to fix)

All of them run in CI on every pull request.

The commit that reformatted the codebase with Prettier is listed in .git-blame-ignore-revs. To skip it in git blame, run git config blame.ignoreRevsFile .git-blame-ignore-revs.

Releasing

Run the "Release Version" workflow on GitHub. It bumps the minor version, adds the commits since the last Bump X.Y commit to CHANGELOG.md, builds the userscript and opens a pull request with the result.

Writing a feature

Each feature in src/features is created with createFeature() and listed in src/index.tsx. Features run on page load and again whenever the URL changes (changes of the hash alone don't count).

Before running a feature again, the runner cleans up everything its previous run registered on the FeatureContext passed to execute:

• mount(element, anchor, options) renders React next to or inside an element,
• signal removes listeners added with addEventListener(type, listener, { signal }),
• onCleanup(callback) undoes anything else, e.g. a class added to body.

State that must outlive a rerun, like a running auto traveller, lives outside the components.

A feature that players can turn off gets a toggle in SETTINGS in src/settings/stuff-settings.ts, which the settings panel lists. Toggles are kept in localStorage.stuff, where true means off, like the legacy script stored them. A feature that acts without a click, like eating food, is marked isAutomatic: it stays off until a player turns it on.

To react to the game's own requests, use onXhrLoad(urlPattern, listener, { signal }).

eRepublik's custom Map

eRepublik replaces the global Map with its own object, which breaks React and other libraries. vite.config.ts takes the original Map from a hidden iframe and makes all bundled code use it: the production bundle is wrapped in a function with a Map parameter, and in development every module gets a module-scoped Map constant.