✨ZynoxATM⭐ ATM For RolePlay !

The GUI is configured in config.yml (menu + buttons + background) - texts in messages.yml.
You can customize:

• GUI size (1-6 rows, background scales automatically)
• Item slots (1-indexed slot map included in the config)
• Item materials and glow
• Button amounts in money (default $10 / $50) with the global exchange rate
• Item names, lore and every other text (per language)
• The decorative background: enable/disable and pick a theme

Background themes - 5 ready-made themes are preinstalled, and you can switch them without touching any file. In game:

• /atm theme opens the theme picker: every theme is ONE item, colored like the theme, with the colors listed in the tooltip and the active theme marked ACTIVE. Click a theme to apply it.
• /atm theme <name> applies a theme directly (uppercase/lowercase does not matter, works from the console too). Unknown name? You get the full list of available themes back.
• A theme chosen in game is saved back to config.yml automatically - it survives restarts and you do NOT need /atm reload. Only the active-theme line changes; your comments and settings stay untouched.
• Prefer editing the config? Change active-theme: to a theme name and run /atm reload:

Each theme is a list of materials cycled through every free slot - edit them or add your own the same way. The same validation protects the in-game command: an unknown /atm theme name is answered with the list of valid themes. If a config value is ever wrong (unknown theme, bad material, broken indentation), /atm reload warns you in-game and in the console instead of failing silently.

Players deposit emeralds without holding them in hand. ZynoxATM counts them in the whole inventory, removes exactly what it needs and adds the money to the Vault balance - in that order, with a full rollback if anything fails, so a transaction can never create or destroy value.

Players withdraw money from their Vault balance and receive emeralds. Shift-Click withdraws as much as BOTH the balance AND the free inventory space allow - it never overfills your inventory and never drops items on the floor.

Nine configurable events, each with its own sound - all in config.yml:

• open (the ATM powers on) / close (soft power down)
• click (small tick on every press)
• deposit (cash in) / withdraw (cash out)
• error / insufficient balance / full inventory
• receive (ATM item given)

Set any sound to "" to mute that event, or flip the master switch to turn all sounds off. Shift-Click "ALL" transactions play a richer two-note chime automatically. Sounds run through a version-proof engine, so the same config works on every supported server version - no silent sounds, ever.

All plugin texts live in messages.yml: notifications, command feedback, GUI names and lores, the help menu, info screen - everything, in BOTH languages side by side (en: and fa .
General notifications follow the action-bar setting, while warnings like insufficient balance always reach the player so nobody clicks into the void.
Placeholders: {player}, {amount}, {balance}, {items}, {item}, {rate} and more.
Full color support: classic codes (&a, &l...), hex (&#ff5500) and smooth gradients - rendered per character on 1.16+, with clean classic fallback on older servers.

The plugin language can be changed from config.yml:
Changing the language updates every message and interface text instantly (after /atm reload). Missing keys in your custom language automatically fall back to English - and you can ADD your own language section (de:, es:, tr:...) the same way.

The default ATM block is GRAY_CONCRETE (fully configurable, display name and lore too).
Only the special ATM item is a real ATM - normal blocks of the same material remain normal blocks.

• Right-click a placed ATM to open the menu.
• Breaking it returns the real ATM item (configurable).
• Pistons cannot move placed ATMs.
• Explosions drop the ATM item back instead of destroying it.

Does ZynoxATM add its own money system?
No. It uses your existing Vault economy (EssentialsX, CMI, XConomy...) - player balances stay exactly where they are.
Which server versions are supported?
One single jar for Paper/Spigot 1.16.5 up to the newest 26.x releases. No separate downloads, no version-specific builds.
Can players duplicate items or money through the ATM?
No. The GUI is fully locked and every transaction moves items first, with exact counting and full rollback - it can never create or destroy value.
Do normal blocks work as ATMs?
No. Only the special ATM item from /zynoxatm give carries hidden data and becomes a working ATM - creative-menu blocks of the same material do nothing.
Can I translate the plugin?
Yes - English and Farsi ship inside messages.yml, and you can add your own language section in the same file. Missing lines fall back to English automatically.
Can I mute or change sounds?
Yes - nine sound events in config.yml, each with its own Bukkit sound name. Set any to "" to mute it, or the master switch to silence everything.
How do I change the GUI theme?
In game: /atm theme opens a picker menu (one item per theme, active one marked) and /atm theme <name> applies a theme directly. Your choice is saved to config.yml automatically. You can also set active-theme in config.yml and run /atm reload.

1.1.2

• NEW: /atm theme - switch GUI themes IN GAME. Without a name it opens a theme picker menu (every theme is one item); /atm theme <name> applies a theme directly. Tab completion included, works from the console too.
• Themes chosen in game are saved back to config.yml automatically - they survive restarts, no reload needed, comments stay untouched.
• New permission: zynoxatm.theme (op by default).

1.1.1

• All 5 themes now ship PREINSTALLED - switching is one word in config.yml, no copying or uncommenting.
• Broken config values can no longer fail silently: clear console warnings plus an in-game warning after /atm reload.