UltimateCashPrinter

UltimateCashPrinter -----

Passive income meets Minecraft: customizable money printers with upgrades, GUI, particles, and Vault

Ultimate Cash Printer
Passive Income Meets Minecraft: Customizable Money Printers

[hr]

Overview

Ultimate Cash Printer brings dynamic, upgradeable money printers to your Minecraft server. Each printer consumes defined resources (e.g., paper, ink sac) over time to generate virtual currency through Vault. With multiple tiers, intuitive GUIs, holographic displays, and full multi-language support, players can manage their printers efficiently while enjoying immersive feedback like sounds and particles.

[hr]

Key Features

Multi-Level Printer Models
- Define custom printer types (basic, pro, etc.) with multiple levels (level0, level1, level2…).
- Each level has its own production rate (amount), storage capacity (capacity), and upgrade cost (cost).
Custom Block or Head
- Toggle useSkull to place printers as PLAYER_HEAD with a Base64 texture.
- If disabled, use any configured block such as CHEST or BARREL.
Intuitive GUI & Upgrade Menu
- Main GUI (3×3) for inserting ingredients and redeeming cash.
- Secondary Upgrade GUI (3×9) displays available levels, costs, benefits, and current level.
Holographic Status Display
- Hovering holograms show:
  - Production rate (per second)
  - Current balance vs. capacity
  - Owner name, printer type, and current level
Vault Integration
- Automatically deposits generated funds into player economy accounts.
- Compatible with any Vault-supported economy plugin (e.g., EssentialsX, iConomy).
Multi-Language Support
- Built-in language files: lang/en.yml, lang/it.yml, lang/fr.yml, lang/de.yml, lang/es.yml, lang/ru.yml, lang/zh.yml.
- Switch languages on the fly—no server restart needed.
Customizable Sounds & Particles
- Configure generation, redemption, and upgrade sounds (volume & pitch).
- Optional particle effects under printers to visualize currency generation.
Hopper & Auto-Withdraw Support
- Allow hoppers (with ultimatecashprinter.hopper permission) to feed ingredients automatically.
- Auto-Withdraw can deposit stored funds when reaching a configurable threshold (autoWithdraw.threshold_percent).

[hr]

Available Placeholders

[hr]

Commands

/cashprinter list – Opens a GUI listing all your printers (requires ultimatecashprinter.list).
/cashprinter <type> – Spawns a printer of specified type (admin only, requires ultimatecashprinter.admin).
/cashprinter reload – Reloads plugin configuration and language files (requires ultimatecashprinter.admin).

[hr]

Permissions

ultimatecashprinter.use – Allows player to use any printer.
ultimatecashprinter.use.<type> – Allows player to use specific printer type (e.g., ultimatecashprinter.use.basic).
ultimatecashprinter.hopper – Enables hopper input support for printers.
ultimatecashprinter.autowithdraw – Enables Auto-Withdraw feature.
ultimatecashprinter.list – Allows use of /cashprinter list command.
ultimatecashprinter.admin – Allows admin commands: /cashprinter <type>, /cashprinter reload.

[hr]

Installation

Download the latest .jar from the Spigot Resource page.
Place UltimateCashPrinter-1.1.jar into your server’s plugins folder.
Ensure dependencies are installed:
- Vault (e.g., EssentialsX)
- Any Vault-compatible economy plugin (e.g., iConomy)
Start or restart the server.
On first run, config.yml and language files will generate in plugins/UltimateCashPrinter/.
(Optional) Add or customize additional language files in plugins/UltimateCashPrinter/lang/.

[hr]

Configuration

All settings reside in plugins/UltimateCashPrinter/config.yml. Below is a snippet of core sections:

Code (Text):

language: en
prefix: "&6[UCP]&r "

printers:
basic:
useSkull: true
skullTexture: "<Base64-Texture-String>"
block: PLAYER_HEAD
interval: 40
recipe:
PAPER: 2
INK_SAC: 1
level0:
amount: 1.0
capacity: 500
cost: 0
level1:
amount: 2.0
capacity: 1000
cost: 250
level2:
amount: 3.0
capacity: 1500
cost: 500
pro:
useSkull: false
block: CHEST
interval: 30
recipe:
GOLD_INGOT: 5
DIAMOND: 1
level0:
amount: 5.0
capacity: 2000
cost: 0
level1:
amount: 10.0
capacity: 4000
cost: 1000

autoWithdraw:
enabled: true
threshold_percent: 80

sounds:
generate:
enabled: true
sound: BLOCK_NOTE_BLOCK_PLING
volume: 1.0
pitch: 1.0
upgrade:
enabled: true
sound: ENTITY_VILLAGER_YES
volume: 1.0
pitch: 1.2
particles:
enabled: true
type: SMOKE_NORMAL
count: 6
offsetX: 0.25
offsetY: 0.10
offsetZ: 0.25

[hr]

Changelog

v1.2.0 – Added Hopper support, Auto-Withdraw, Expanded Permissions, “My Printers” GUI, Full Localization, and Custom-Skin Blocks.
v1.1.0 – Improved GUI, Added Custom Sounds & Particles, Fixed Hologram Updates, Extracted All lang/.yml Files, Bugfixes for Persistence & Permissions.
v1.0.0 – Initial Release: Basic Production, Vault Integration, Manual Redemption, and Single-Level Printers.

[hr]

Screenshots