Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

iTechGuides is reader-supported. When you buy through links on our site, we may earn an affiliate commission. As an Amazon Associate I earn from qualifying purchases. Learn more

Change a Sponge server’s plugin location by editing the plugins-dir value inside the sponge { general { } } block of global.conf, then restart the server. Set the value to either a folder relative to the server’s execution root or an absolute path, create that folder, and move the plugin JAR files into it.

Do not use this setting for Mixin-based plugins: those must remain in the server’s mods folder. Also check your Sponge API version first, because the documented default differs between API generations.

What’s actually slowing this PC down?

Pick the symptom - the matching free tool is one click away.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

What plugins-dir changes

Sponge uses the plugins-dir setting to add a folder to its plugin search path. The setting belongs to the global Sponge configuration, not to an individual plugin configuration file:

sponge {
    general {
        plugins-dir="plugins"
    }
}

The path can be relative to the server’s execution root or written as an absolute filesystem path. A relative path is usually easier to move between machines; an absolute path is useful when plugins are stored on a separate volume or outside the game directory.

#1 Best Overall
Sale
Compressed Air Duster,130000RPM Super Power Cordless Air Duster,Rechargeable Brushless Blower,3 Gear Adjustable Blower with LED Light,Dust Remover for Computer/House/Outdoor/Car
  • Powerful Turbo Fan:CAGIWIRU Electric Air Duster have reached speed up to 130000RPM,Can efficient remove dust and debris.With LED light and Three Adjustable Speed to meet with different cleaning tasks.
  • With Attached USB C Fasting Charging cable.Charing 3 hours,Enjoy up to 240 minutes of use on the lowest setting, For third speed can use for 25mins.with four charging options to meet with your needs.
  • Wide Application:Upgraded attached 5 different nozzles,making it suitable for a variety of scenes, such as car,pet, pc, keyboards, and other electronic devices. It also serves for office and home clean duster.
  • Handy Design & Portable:Cordless air duster electric nozzle is Light weight and small size, design and comfortable to hold and space saving, convenient to carry around. You can put it in your room or inside the car without taking up space.
  • Warranty & Support: Our Electric air duster comes with 5 years warranty and 24/7 customer service. During this period, if you have any questions,pls kindly feel free to contact us.

This setting controls where Sponge looks for plugin JARs. It does not relocate every file associated with a plugin. Plugin configuration files are controlled separately by config-dir, so changing plugins-dir does not automatically move the server’s configuration directory.

Mixin-based plugins are a separate case. They must remain inside mods even when an additional plugin directory is configured. Moving one of those JARs to the new plugin folder can prevent it from loading.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Check the Sponge API version before changing anything

The default location is not described identically across Sponge documentation, so do not assume that every server uses the same folder. The Sponge 8.0.0 quick start separates the defaults by API generation, while the Sponge 7.4.0 configuration documentation describes a default based on the canonical mods directory. The Sponge 8.0.0 installation page also discusses plugins under mods/plugins and custom locations. Use the API version and the configuration shipped with your build as the authority for your server.

Sponge/API context Documented default or guidance What to verify
API 7 and earlier The Sponge 8 quick start lists /mods for API 7 and earlier. Sponge 7.4.0 configuration documentation describes the default plugin search folder as ${CANONICAL_MODS_DIR}/plugins. Check whether your build expects plugins directly in mods or in its mods/plugins location, and follow the existing configuration.
API 8 and later The Sponge 8 quick start lists /plugins. The Sponge 8 installation guidance also says plugins may be placed in /mods/plugins/ or in a custom folder set by plugins-dir. Confirm the behavior for the exact Sponge API and platform version you installed instead of relying on a generic path.
SpongeForge versus SpongeVanilla The setting is intended to be configured through Sponge’s global configuration, but an old SpongeVanilla report raised concerns about changing the directory with this option. Treat old platform-specific reports as historical; test the setting on the current build and keep a rollback copy of the original configuration.

For Sponge 8, the global file is normally created at config/sponge/global.conf in the server folder. Other builds may use an equivalent Sponge global-configuration location. If your installation uses a different filename or directory, use the file created by that build rather than creating a second configuration file that Sponge will ignore.

Move plugins to a different directory

  1. Stop the server cleanly. Shut down the Sponge server before editing its configuration or moving JAR files. This prevents the process from writing over your changes and avoids moving files while they are being read.
  2. Back up the configuration and plugin folders. Copy global.conf and the current plugin directory to a safe location. A backup lets you restore the previous search path if the server starts without its plugins.
  3. Open the global Sponge configuration. On Sponge 8, open config/sponge/global.conf in the server’s game directory. On another build, open that build’s equivalent global configuration file.
  4. Find the sponge block and its general block. The setting must be nested in this section. Do not put it at the top level, inside a plugin’s own configuration, or in a separate file.
  5. Set plugins-dir to the target folder. Use a quoted path. For a folder named plugins in the server’s execution root, the entry can be:
sponge {
    general {
        plugins-dir="plugins"
    }
}
  1. Create the target directory. Make the folder before starting the server. If the value is relative, create it relative to the directory from which the server executes. If you use an absolute path, create that exact path and make sure the account running the server can read it.
  2. Move the plugin JAR files. Move ordinary Sponge plugin JARs from the old location into the new directory. Leave Mixin-based plugins in mods. Do not leave two copies of the same plugin in both locations, because duplicate copies can cause loading conflicts.
  3. Start the server and check plugin loading. Watch the startup output for errors and confirm that the expected plugins are recognized. If the server starts but the plugins are absent, stop it and work through the troubleshooting section rather than repeatedly changing unrelated settings.

Choose the path syntax

Relative path in the server root

A relative value keeps the plugin directory alongside the game files. This is the simplest arrangement when the server and plugins are backed up or moved together:

Rank #2
EVEO® Screen Cleaner Spray Kit (Streak-Free) TV Screen Cleaner for Smart TV, Lcd, LEd, Oled | Computer Screen Cleaner Spray and Wipe Microfiber Cloth - TV, Monitor, Laptop, iPad, Car - 6.7oz 1 Pack
  • Screen Cleaner is Your Screen’s New Bestfriend! - EVEO is proud to present a screen cleaner that’s perfectly suited for your TV. Meet your new screen cleaner, computer screen cleaner, laptop cleaner, iPad cleaner, Macbook,tv cleaner or any other electronic device. Our screen cleaner spray and wipe along with the included plush microfiber cloth, easily removes dust, fingerprints & other smudges on the screen’s surface. Clean effectively for a streak-free screen
  • Gentle on your Screens - Our screen cleaner spray and wipes is compatible to be used even for the most sensitive LCD, LED, CRT, and OLED screens in proper use. Be at ease knowing that this product is compatible with all the major brands: LG, SONY, Samsung, Sharp, iPad, iPhone, Android screens, Kindle, PC monitors - we’ve got you covered! Can be used as LCD screen cleaner, tv cleaner, smart tv screen cleaner, and more
  • Premium Super Soft Plush Microfiber Cloth - Included in this efficient screen cleaning kit. This screen cleaner spray and wipe has our signature plush microfiber cloth specially designed to comply with screens and monitors and leave them streak-free. Has been shown to effectively absorbs stubborn stains, zero streaks, and no fiber shedding. Always use this together with our screen cleaner for the best results
  • Easy-to-Use Screen Cleaner Kit + microfiber cleaning cloth - The EVEO Screen Cleaning Kit will easily be your new favorite tool when it comes to taking care of the things you love most, quick and easy solution for a streak-free screen. Simply screw on the sprayer gun on the screen cleaner bottle. Spray the cleaning liquid onto the microfiber cloth, then wipe the screen until desired cleanliness & shine is achieved.
  • Quality Screen Care Kit Worth Purchasing - Enjoy a convenient Screen Cleaner anytime, anywhere you need it. Your satisfaction is our top priority. We stand behind the quality of our products and that’s why, you shouldn’t be worrying at all. We manufacture the Best Screen Cleaner. and can be used for laptop cleaning kit, laptop screen cleaner, tv screen cleaner for smart tv. MacBook screen cleaner, monitor cleaner or screen cleaner spray for electronic devices with microfiber cleaning cloth
plugins-dir="plugins"

Create a plugins directory in the server’s execution root. The exact root is the directory Sponge treats as the game or execution directory when the server starts; it is not necessarily the directory containing your text editor’s shortcut or control-panel installation.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Path using the canonical game directory

Hosting guides commonly show the canonical game-directory variable when the desired folder is in the game root:

sponge {
    general {
        plugins-dir="${CANONICAL_GAME_DIR}/plugins"
    }
}

This expresses the same layout while making the intended game root explicit. Variable handling can differ between platforms and older builds, so test the current server after saving the file. An older report specifically suggested that SpongeVanilla did not read a ${CANONICAL_GAME_DIR} value in a Sponge 6-era setup, while SpongeForge did; that report is not confirmation of behavior in current releases. If the variable form fails, use a path syntax documented for your build or an absolute path.

Absolute path outside the game directory

An absolute value points Sponge directly to a directory elsewhere on the machine:

plugins-dir="/srv/my-sponge-plugins"

Use the path format required by the operating system. The server process must have permission to traverse the parent directories and read the JAR files. An absolute path also means that restoring or moving the server requires an additional directory migration; record it in your deployment notes.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
BladeHawks RGB Gaming Mouse Pad Extra Large Extended 31.5x12 Inch-Black
  • 【Large size】:Measuring 800 x 300 mm/ 31. 5×12 inches, which is wider and taller than others. Large mouse pad can perfectly fit your keyboard and mouse of any size, and there is also ample space for peripherals such as phones, tablets, etc.
  • 【LED backlight mouse pad】:Blade Hawks RGB mouse pad provides 7 static modes and 7 dynamic modes will give you the options you are looking for. Power-off memory function remembers the last lighting mode you selected. The super glow fiber Chroma will give you a colorful gaming setup that you want.
  • 【Anti-slip rubber base】:Made from Natural rubber, this gaming mousepad will firmly grip your desktop, allowing you to enjoy the ultimate precision in the games you are most passionate about. It also comes with a texture that enhances this ability even further.
  • 【Smooth and waterproof surface】: Micro-textured cloth surface, for extremely precise mouse control and a smooth movement. When liquid splashes on the gaming mouse pad, it forms water droplets and slides down. Will not delay your work or gameplay.
  • 【Plug and play】: This mouse and keyboard pad is powered by USB, plug and play, no driver required. One button control light modes. Press one time to change the lighting mode, press twice to change the brightness, press and hold about 3 seconds turn ON/OFF.

Keep plugin files and plugin configuration separate

Changing plugins-dir changes the location Sponge searches for plugin binaries. It does not, by itself, change the location of plugin data. The separate config-dir setting controls configuration folders, whose default is commonly /config.

That distinction matters during a migration:

  • Move the plugin JARs to the directory named by plugins-dir.
  • Leave existing plugin configuration files where the server’s config-dir points unless you are deliberately changing that setting too.
  • Do not copy configuration files into the new plugin directory expecting Sponge to discover them there.
  • Back up both the JAR directory and the configuration directory before making a large move.

If a plugin starts with default settings after the move, first check that its configuration files are still in the configured config directory. A changed binary path and a changed configuration path are independent operations.

Restart versus reload

A full restart is the safest way to apply a new plugin directory. Sponge’s stable installation guidance says the server must be restarted to change plugins. Stop the process, save global.conf, create the target directory, move the JARs, and start the server again.

Sponge 8 configuration documentation also describes reloading global configuration with:

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
/sponge reload -g

Reloading can be useful when you are testing a configuration edit, but it is not a substitute for a restart when plugin discovery or plugin lifecycle behavior is involved. If you use the reload command, make sure the command is accepted by your exact build and still perform a clean restart if the new directory is not reflected immediately. Do not remove or move active JARs while the server is running.

Rank #4
Sale
Vaydeer Wrist Rest for Keyboard and Mouse, Computer Ergonomic Wrist Support Pad, Soft Memory Foam Arm Cushion for Desk, Palm Hand Office Laptop Typing
  • 【Softer and More Comfortable】Vaydeer wrist rest has unique diamond pattern, which is the combination of softness and aesthetics. The materials of wrist rest are improved into higher quality memory foam and covered with silky smooth lycra. The computer wrist rest makes you as comfortable and cushiony as like rest your wrists on clouds.
  • 【Ergonomic Wrist Saver】The wrist rests for keyboard and mouse comes with a 17.32×3.15×0.83 inch keyboard wrist pad and a 5.94×3.15×0.83 inch mouse wrist support. Based on ergonomic design, the unique concave shape is the perfect fit for your wrist joints. The wrist rest pad fits most computer keyboards and laptops, improve hand and wrist posture, release your wrist and arm stress.
  • 【Non-Slip Rubber Bottom】Featuring an anti-skid silicone base on the bottom, this wrist keyboard support stays firmly in place on your desk, preventing the padding from sliding around, ensuring stable and consistent wrist support during extended computer sessions.
  • 【Better Experience & Pain Relief】Our keyboard arm rest is beneficial to alleviate the soreness caused by direct contact and friction between your arm and a hard desk surface, reducing the risk of wrist fatigue or carpal tunnel. The soft texture of memory foam can evenly distribute the pressure around your wrists and provide good support with just enough give.
  • 【Helpful in Multiple Scenarios】Whether you're working, studying, writing, typing, gaming, this keyboard and mouse rest combo is an essential accessory to add comfort and support to your hands and wrists. It’s also a great gift for men, women, family, friend, coworker, gamer, teacher, etc.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot a plugin directory that is not working

The server starts but no plugins from the new folder load

  • Confirm that the key is spelled exactly plugins-dir, including the hyphen.
  • Confirm that it is inside sponge { general { } } in the global Sponge file.
  • Check that you edited the file belonging to the server instance you actually started. Hosting panels sometimes expose several game directories.
  • Check whether the path is relative to the execution root you expected. A relative value can point somewhere different when the server is launched by a service or panel.
  • Verify that the target directory exists and contains the plugin JARs, not compressed archives, shortcuts, or files left in the old directory.
  • Perform a complete restart after saving the file.

The path appears correct, but the server cannot read it

For an absolute or outside-the-game path, check filesystem permissions for the operating-system account running Sponge. The account needs access to every parent directory as well as the JAR files themselves. Correct the permissions or choose a directory within the server’s accessible tree, then restart.

A Mixin-based plugin stopped working

Move that plugin back into mods. The plugins-dir setting does not override the requirement that Mixin-based plugins reside in the mods folder.

The configuration change seems to be ignored

Look for syntax damage around the sponge and general braces. HOCON nesting must remain balanced, and the path should be a quoted string. Compare the edited file with the backup and make one change at a time. Also verify the build’s exact configuration filename; Sponge 8 uses global.conf, but an equivalent file may be used elsewhere.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

The canonical game-directory variable does not resolve

Replace the variable expression with a path syntax supported by your build. The historical SpongeVanilla report about ${CANONICAL_GAME_DIR} concerns an older setup and should not be generalized to every current SpongeVanilla release. Testing the literal path on the current server is safer than assuming variable expansion works.

Plugins load twice or behave inconsistently

Stop the server and search the old and new locations for duplicate copies of the same JAR. Keep one copy in the intended directory and leave Mixin-based files in mods. Duplicate files can make it unclear which copy Sponge is attempting to load.

Best Value
Sale
Under Desk Cable Management Tray No Drill, Metal Mesh Cable Management Under Desk with Clamp Mount, 2 Hole Cable Tray with Wire Management and Cord Organizer for Home Office Standing Desk
  • 【No Drill Mounted】Cable management tray can be assembled in as little as 3 minutes or less-simply. Side clips easily clampe the edge of desk, pass through the holes on the sides, and secure excess cables with baskets. Desk cable management supports inward or outward installation to meet your needs in different scenarios, and provides you with great convenience when collecting and organizing wires.
  • 【Rubber Pad Protects Desk】Wire organizer under desk built-in soft rubber pads on the clamp protect your desk from scratches, so you will not damage your furniture or office.
  • 【Sturdy and Beautiful】Cord management under desk is made of high-quality carbon steel and holds about 15 lbs. The wire basket has 2 holes on each side of the tray to enable your cables to pass freely. Cable baskets are suitable for desk thickness use from 0.4" to 2.4".
  • 【Space Saving & Keep Organized】Desk cable management tray holds all your power cords, outlet strips, USB hubs and computer transformers hidden from your feet, and the data cables will not enter the vacuum cleaner to keep your desk clean and tidy. Desk wire organizer is also suitable for use in the kitchen and outdoors.
  • 【Reduce Safety Risks】Cable tray under desk keeps all plugs away from your kids, no more worry about tripping. Using 2 holes wire tray saves extra space, helps you easily cabling and wire protection. The mesh design is not easy to accumulate dust, but avoids safety accidents caused by messy wires.

Recommended layouts

API 7-style layout

For a build following the Sponge 7 documentation’s default, ordinary plugins may be kept under the canonical mods directory’s plugin subfolder:

server/
├── mods/
│   ├── mixin-plugin.jar
│   └── plugins/
│       └── ordinary-plugin.jar
├── config/
│   └── sponge/
│       └── global.conf
└── ...

If you choose a different folder, set plugins-dir explicitly and preserve the separate mods location for Mixin-based plugins.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Game-root layout

A custom game-root folder keeps ordinary plugin JARs separate from the mods tree:

server/
├── mods/
│   └── mixin-plugin.jar
├── plugins/
│   └── ordinary-plugin.jar
├── config/
│   └── sponge/
│       └── global.conf
└── ...

Use either plugins-dir="plugins" or the canonical-game-directory form supported by your build. The directory layout alone does not activate the move; the configuration key must point to it.

Migration checklist

  • Identify the Sponge API version and whether the server is SpongeForge or SpongeVanilla.
  • Locate the active global Sponge configuration file.
  • Back up global.conf, the current plugin directory, and plugin configuration data.
  • Stop the server before editing.
  • Set plugins-dir under sponge { general { } }.
  • Use a quoted relative or absolute path that your build supports.
  • Create the target directory and verify its permissions.
  • Move ordinary plugin JARs; keep Mixin-based plugins in mods.
  • Do not move plugin configuration files unless you also intend to change config-dir.
  • Restart the server and inspect startup behavior.
  • If the change fails, restore the backup and test the path, nesting, filename, and platform-specific behavior individually.

What to remember about Sponge plugin locations

The reliable part of the procedure is the configuration key and its scope: edit plugins-dir in the global Sponge configuration’s sponge.general block, create the destination, move ordinary plugin JARs, and restart. The default path is version-dependent, so API 7 documentation, API 8 quick-start guidance, and the installation page should not be treated as interchangeable. Mixin-based plugins remain in mods, and plugin configuration files remain governed by config-dir.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.