Stuff++ Unlocked
Features extension script for eRepublik.com.
Installation
- Install Tampermonkey.
- Open Stuff++ unlocked url.
- Tampermonkey page should appear. Install the script.
- Refresh your eRepublik page.
- 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
How to donate?
- Go to this profile.
- Donate money.
- 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
- Run
npm start to start the development server on port 8124.
- 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.
- 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 - TypeScriptnpm run lint - ESLintnpm test - Vitest unit testsnpm 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.
