system-token-plugin (STP) icon

system-token-plugin (STP) -----

[STABLE] This is a prototype of a token system (economy) and a custom enchantment system.



system-token-plugin (STP) Beta 1.0
# System Token Plugin (STP)

A Minecraft Spigot 1.8.8 plugin for a custom token-based economy and pickaxe enchantment system, designed for prison servers.
This project is in an **early/incomplete stage** and under active development.

---

## Features (Planned & Implemented)

- ✨ Token Economy
Add, remove, set, and check player tokens with commands. Tokens are stored in a local SQLite database.

- ⛏️ Custom Pickaxe System
Give players a special pickaxe with custom display name, lore, and persistent NBT data.

- ✨ Custom Enchantments
- Speed, Explosive, Efficiency, Fortune, Fly, Nuke, Give-Token (all configurable)
- Each enchantment has configurable `cost-per-level` in `config.yml`.
- Enchantments are stored as custom NBT tags and reflected in the pickaxe lore.
- Some enchantments (like Explosive and Fortune) have custom effects on block break.
- Subir de nivel un encantamiento cuesta tokens según el config, y bajar de nivel reembolsa el 90% del costo.

- ⛏️ Pickaxe Protection
Prevent accidental dropping of the custom pickaxe (requires double-tap Q).

- ✨ Persistent Storage
- Tokens and pickaxes are saved in SQLite databases.
- Pickaxes are restored on player respawn after death.

- ⚙️ Configurable
- All enchantments, pickaxe display, allowed blocks, and database settings are configurable in `config.yml`.
- Tab-completion para todos los comandos y subcomandos.

- **Customizable Messages**
- All plugin messages (prefix, errors, notifications, etc.) are fully customizable in `config.yml` under the `messages:` section.
- Supports placeholders like `%player%`, `%amount%`, `%enchant%`, `%level%`, etc.



---

## Commands

Code (Text):
Available Commands:

/token
Main command to manage tokens (see subcommands below).

/token balance
Check your token balance.

/token add <player> <amount>
Add tokens to a player.
Required permission: token.add

/token remove <player> <amount>
Remove tokens from a player.
Required permission: token.remove

/token set <player> <amount>
Set a player's token balance.
Required permission: token.set

/token enchant <sub> <player> <enchant> <level>
Manage enchantments: set, nextlevel, downlevel.

/givepickaxe
Give yourself the custom pickaxe.

/enchantsreload
Reload enchantments from the config file.
Required permission: stp.reload
 
**Tab-completion** is available for all commands and subcommands.

## ⚡ Example Config (`config.yml`)

Code (Text):
# Configuración básica del pico
pickaxe:
  display-name: "&f&lPICO &7&l| &a&lINICIAL"
  lore:
    - ""
    - "&fDueño: &f%player%"
    - ""
    - "&a&lEncantamientos:"
    - "&2» {}"

# Encantamientos
enchants:
  speed:
    display: "&7Speed"
    max-level: 2
    enabled: true
    cost-per-level: 2000
  explosive:
    display: "&7Explosive"
    max-level: 50
    enabled: true
    chance: 70
    cost-per-level: 100000
  efficiency:
    display: "&7Efficiency"
    max-level: 100
    enabled: true
    cost-per-level: 1000
  fortune:
    display: "&7Fortune"
    max-level: 20
    enabled: true
    cost-per-level: 5000
  fly:
    display: "&7Fly"
    max-level: 1
    enabled: true
    cost-per-level: 1000000
  nuke:
    display: "&7Nuke"
    max-level: 1
    enabled: true
    chance: 0.1
    cost-per-level: 1000000
  give-token:
    display: "&7Recolector de tokens"
    max-level: 20
    price-for-level: 10
    messageStatus: true
    enabled: true
    cost-per-level: 1000

# Bloques permitidos
allowed-blocks:
  - STONE
  - COBBLESTONE
  - IRON_ORE
  - GOLD_ORE
  - DIAMOND_ORE
  - DIAMOND_BLOCK
  - EMERALD_BLOCK

fortune-blocks:
  - DIAMOND_BLOCK
  - EMERALD_BLOCK

# Base de datos
database:
  host: localhost
  name: minecraft
  username: usuario
  password: contraseña

message-prefix: "&e&lTOKENS &f» &7"

messages:
  general:
    no-permission: "No tienes permiso para hacer esto."
    plugin-enabled: "Plugin habilitado correctamente."
    plugin-disabled: "Plugin deshabilitado correctamente."
    enchants-reloaded: "¡Encantamientos y configuración recargados!"

  nuke:
    activated: "¡Nuke activado exitosamente!"
    invalid-mine: "No estás en una mina válida."

  explosive:
    activated: "¡Explosión activada!"

  give-token:
    received: "Has recibido &e%tokens% &7tokens por romper un bloque con &e%enchant%&7."

  token:
    add-usage: "Uso: /token add <jugador> <cantidad>"
    remove-usage: "Uso: /token remove <jugador> <cantidad>"
    set-usage: "Uso: /token set <jugador> <cantidad>"
    give-usage: "Uso: /token give <jugador> <cantidad>"
    pay-usage: "Uso: /token pay <jugador> <cantidad>"
    balance-usage: "Uso: /token balance [jugador]"
    player-not-found: "Jugador no encontrado."
    invalid-amount: "La cantidad debe ser un número positivo válido (ej: 1500, 1.5K, 2M, 3B, 1.5Q)."
    add-success: "Se añadieron &e%amount% &7tokens a &e%player%&7."
    remove-success: "Se eliminaron &e%amount% &ctokens de &e%player%&c."
    set-success: "El saldo de tokens de &e%player% &7se ha establecido en &e%amount%&7."
    give-success: "Has dado &e%amount% &7tokens a &e%player%&7."
---

## ⚠️ Status

> **This plugin is in an early/incomplete stage.**
> Many features are experimental or under development.
> Use at your own risk and expect breaking changes.

---

## License

MIT License
Copyright (c) 2024 Daniel Flores Viera

---

## Contributions

Contributions are welcome!
Open issues or pull requests to help improve the project.

---

## Links
⚒️ [Spigot Page Plugin ]( https://www.spigotmc.org/resources/system-token-plugin-stp.126264/)
----------, Jun 22, 2025
Resource Information
Author:
----------
Total Downloads: 79
First Release: Jun 21, 2025
Last Update: Jul 4, 2025
Category: ---------------
All-Time Rating:
1 ratings
Find more info at github.com...
Version -----
Released: --------------------
Downloads: ------
Version Rating:
----------------------
-- ratings