Configuring Items and Special Tools in Pixelmon
The Item and Special Tool section contains the options Pixelmon uses for this part of the server. Configure Bottle Caps, Mega Stones, tool permissions, cooldowns, and other special item behavior.
Pixelmon Item and Special Tool Settings
The settings below are listed in the same order as they appear in items.yml. The table preserves each default and identifies the accepted value type. The Setting column shows a reader-friendly name first, followed by the matching items.yml key for reference.
| Setting and Config Key | Default and Accepted Values | Description |
|---|---|---|
| Bottle Cap Level bottle-cap-level | Default: 50 Values: whole number | At what level bottlecaps can be used on a Pokemon. |
| Multiple Photos Of Same Pokémon multiple-photos-of-same-pokemon | Default: true Values: true or false | Determines if the player can take multiple photos of a single Pokemon |
| Average Lure Expiry Ticks average-lure-expiry-ticks | Default: 17920 Values: whole number | How many ticks it will take for a lure to expire on average. |
| Spawners Op Only spawners-op-only | Default: true Values: true or false | Whether or not players have to be ops to edit Pixelmon spawners. If this option is disabled, any player in Creative mode can edit spawners. |
| NPC Editor Op Only npc-editor-op-only | Default: true Values: true or false | If set to true, must be opped to use the NPC Editor. If false, must be in Creative mode. |
| Allow Pokémon Editors allow-pokemon-editors | Default: true Values: true or false | Whether or not players can use Pokémon editors. When disabled client-side, this will prevent other players from using Pokémon editors on the player with the setting disabled. |
| Allow Chisels allow-chisels | Default: true Values: true or false | Whether or not players can place statues using a Chisel. |
| Default Mega Stone Time default-mega-stone-time | Default: 5400000 Values: whole number | The default amount of time in milliseconds that a Mega Stone will give to a Pokemon for outside of battle Mega Evolution. |
| Mega Stone Cooldown Multiplier mega-stone-cooldown-multiplier | Default: 3.0 Values: decimal number | The multiplier of a Mega Stone's time to use as its cooldown. |
| Evo Stone Armor Lure Strength evo-stone-armor-lure-strength | Default: 1.0468000173568726 Values: decimal number | The luring strength of each stone used in evolution stone armor. |
| Evo Stone Tool Effects evo-stone-tool-effects | Default: {Firestone: {effect: minecraft:fire_resistance; armor-level: 1; tool-level: 1; tool-duration: 6000; tool-damage: 5}; Moonstone: {effect: minecraft:night_vision; armor-level: 1; tool-level: 1; tool-duration: 6000; tool-damage: 5}; Leafstone: {effect: minecraft:slow_falling; armor-level: 1; tool-level: 1; tool-duration: 6000; tool-damage: 5}; Waterstone: {effect: minecraft:water_breathing; armor-level: 1; tool-level: 1; tool-duration: 6000; tool-damage: 5}; Duskstone: {effect: minecraft:invisibility; armor-level: 1; tool-level: 1; tool-duration: 6000; tool-damage: 5}; Icestone: {effect: minecraft:resistance; armor-level: 1; tool-level: 2; tool-duration: 6000; tool-damage: 5}; Shinystone: {effect: minecraft:health_boost; armor-level: 1; tool-level: 2; tool-duration: 6000; tool-damage: 5}; Sunstone: {effect: minecraft:jump_boost; armor-level: 2; tool-level: 3; tool-duration: 6000; tool-damage: 5}; Thunderstone: {effect: minecraft:speed; armor-level: 1; tool-level: 2; tool-duration: 6000; tool-damage: 5}; Dawnstone: {effect: minecraft:haste; armor-level: 1; tool-level: 2; tool-duration: 6000; tool-damage: 5}} Values: mapping of keys and values | Controls the evo stone tool effects value used by Pixelmon. |
Important Item and Special Tool Setting Notes
Defaults and Value Types
Boolean toggles, numeric rates, timers, lists, and mappings use different value formats. Preserve the value type shown in the table and keep collection syntax intact when changing items.yml.
Settings That Work Together
Several item and special tool options can affect the same outcome. Review related rates, limits, timers, and lists together before deciding that one value is responsible for a result.
Testing Changes
Change one related group of settings at a time so its effect is easy to measure.
Test the result under the conditions affected by the setting, including relevant dimensions, player states, or encounter types.
Keep a copy of the previous values so unexpected balance or performance changes can be reversed quickly.
Final Thoughts
Item and Special Tool settings are easier to balance when changes are deliberate and documented. Start with the defaults, adjust only what the server needs, and verify the result before moving on to the next group.
Need Help?
If you have questions or run into any issues, our support team is here to help! Reach out using the support widget on our website or visit our support center for further assistance.