ExpExtraction · Installation and configuration

Requirements

• A Paper or Folia server.
• The server process must be able to read plugins/ and write the plugin data directory.

Obtain and install

Get a release from GitHub Releases. If no suitable release is available, build from source:

git clone https://github.com/LunaDeerMC/ExpExtraction.git
cd ExpExtraction
mvn clean package

Put the generated JAR from target/ in the server’s plugins/ directory. Fully restart the server. Do not put the plugin JAR in mods/. Keep only one ExpExtraction JAR in the plugin directory.

After the first successful start, check that the following file exists:

plugins/ExpExtraction/config.yml

Run /extract 1 in game as a small smoke test and confirm that the bottle can be created and used.

Permission

The plugin declares one permission node:

Permission	Purpose	Default
expextraction.extract	Use /extract	true

The enchanting-table event does not check this permission separately. Restricting the node limits the command path. It does not prevent players from using an enchanting table with an empty glass bottle.

Configuration

The default configuration has this structure:

commandExtraction:
  enable: true
  maximum: 2000

enchantingTable:
  enable: true
  amount: 100

Setting	Default	Purpose
commandExtraction.enable	true	Controls command extraction. The enchanting-table event also checks it
commandExtraction.maximum	2000	Maximum amount stored by /extract in one bottle
enchantingTable.enable	true	Written to the config, but not read by the enchanting-table event
enchantingTable.amount	100	Amount for the enchanting-table path. The plugin reduces it when the player has less experience

Fully restart the server after editing the configuration. The plugin has no dedicated config-reload command. Do not replace the file while the server is running.

Configuration behavior

To disable both bottle-creation paths, set commandExtraction.enable to false. The bottle-use event does not check this switch. Players can still use existing bottles.

Changing only enchantingTable.enable does not disable enchanting-table extraction. The configuration field and the event use different settings.

Upgrades and troubleshooting

Stop the server before upgrading. Back up the JAR, plugins/ExpExtraction/config.yml, and the server log. Replace the JAR and restart the server. Run a small command extraction and enchanting-table test after the plugin reports that it is enabled.

When troubleshooting, check:

1. the JAR is in plugins/ and the server log reports the plugin as enabled;
2. the server is Paper/Folia and its Java runtime satisfies the server core;
3. /extract has the expextraction.extract permission;
4. table extraction has all four conditions: sneaking, an empty glass bottle, right-clicking an enchanting table, and enough experience;
5. the server was fully restarted after configuration changes rather than only partially reloading plugins.