Using Scripts in eRepublik

To use a JavaScript toolkit/plugin for eRepublik, you need to install it as a user script. This process allows you to run custom JavaScript in your web browser to enhance or modify the behavior of specific websites, like adding features to an online game such as eRepublik.

Table of Contents

• How to Install a User Script
  • Install Tampermonkey or Greasemonkey
  • Add the Script
  • Confirm Installation
• Manage or Edit Scripts
  • ..in Tampermonkey
    • View Installed Scripts
    • Disable/Enable Scripts
    • Script Metadata
    • View All Scripts
• Are Some Browsers Better at This?
• Advantages of Using User Scripts
• Issues to Watch Out For

How to Install a User Script

The most common and straightforward way to install and manage user scripts is to use a browser extension designed for this purpose. The most popular and widely used extensions are:

Install Tampermonkey or Greasemonkey

• Tampermonkey (for Chrome, Firefox, Safari, Edge, Opera, and more)
• Greasemonkey (for Firefox, other Gecko browsers like Pale Moon, SeaMoon, and Waterfox)

Add an Extension named Tampermonkey or Greasemonkey. May need to restart your browser after installing it.

Add the Script

Once you have Tampermonkey or Greasemonkey installed, add the script you want to use:

• Visit the website with the script you want to install, for example, the eRepublik War Page script: https://curlybear.eu/erep/warspage+.user.js
• When you click on the link to the .user.js script file, your browser will ask if you want to install the script via Tampermonkey or Greasemonkey.
• In Tampermonkey, this will automatically open the Tampermonkey dashboard, where you can review and then install the script.
• In Greasemonkey, it will similarly offer you the option to install the script.

Confirm Installation

After clicking the install button, the script will be added to the extension, and it will automatically start running when you visit a supported webpage (like eRepublik).

Manage or Edit Scripts

Manage, enable/disable, or edit your user scripts directly through the Tampermonkey or Greasemonkey interface.

• In Tampermonkey, click on the extension icon, go to Dashboard, and you’ll see a list of your installed scripts.
• In Greasemonkey, you can manage scripts by clicking on the extension icon and selecting Manage User Scripts.

..in Tampermonkey

With Tampermonkey, you can easily manage and view your installed scripts, as well as edit the JavaScript code.

Pin the extension to the toolbar for quick access. Click on the Tampermonkey icon in your browser toolbar. Select Dashboard from the dropdown menu.

To see which scripts are installed in Tampermonkey:

• Click on the Tampermonkey icon in your browser toolbar.
• Select Dashboard from the dropdown menu.

Alternatively, you can go directly to the dashboard by navigating to this URL in your browser:

chrome://extensions/ (for Chrome) or about:addons (for Firefox)

View Installed Scripts

• In the Tampermonkey Dashboard, you’ll see a list of all installed user scripts.

• Each script has its name, the domains it runs on, and whether it’s enabled or disabled.

• View or Edit the JavaScript Code of an Installed Script

To view or edit the JavaScript code of a script that you’ve installed:

• Select the Script
  • In the Tampermonkey Dashboard, click on the name of the script you want to view/edit.
• View/Edit the Code
  • Once you click on the script name, it will open the editor where you can view and edit the JavaScript code.
  • The code will be displayed in a text editor, and you can make changes if needed.
  • After editing, make sure to click Save to store your changes.

Disable/Enable Scripts

To enable or disable a script:

• In the Tampermonkey Dashboard, toggle the checkbox next to the script name to enable or disable it. Disabled scripts won’t run on the specified websites.

Script Metadata

Each Tampermonkey script includes metadata at the top of the JavaScript file. This metadata includes the @name, @namespace, @version, @description, and the @match directives that specify which sites the script runs on. You can also edit this metadata in the editor if necessary.

View All Scripts

You can also quickly see all your installed scripts by clicking on the Tampermonkey icon and selecting Dashboard or Manage Scripts. A list of all your installed scripts will appear, and you can manage them from there.

Are Some Browsers Better at This?

• Google Chrome and Mozilla Firefox are the two most widely supported browsers for user scripts, and both have great support for Tampermonkey and Greasemonkey.
• Safari also supports user scripts via Tampermonkey, though it may be a bit more limited compared to Chrome and Firefox.
• Microsoft Edge (which is Chromium-based) also supports Tampermonkey, making it another good option.

Advantages of Using User Scripts

• Customization: You can tailor the behavior of websites, such as adding new features or modifying existing ones.
• No Need for Extensions: Some scripts can enhance or fix website behavior without needing an entire extension, just the script itself.
• Compatibility: Works well with most modern browsers that support extensions, including Chrome, Firefox, Safari, and Edge.

Issues to Watch Out For

• Security Risks: Always be cautious about where the script is coming from. Make sure you trust the source of the script before running it, as user scripts have access to the content of the websites you visit.
• Script Updates: Occasionally, the script may need to be updated, especially if the website you’re modifying makes changes to its layout or functionality. Some user scripts will stop working if the website structure changes.
• Performance Impact: If you install many scripts or if the scripts are inefficient, it could negatively affect the performance of your browser.