Monedas y formato de números

Todo lo que cuesta o paga en PulsePrison usa una moneda de currencies.yml: encantamientos, atributos, logros, autominers, mejoras de mina, impuestos de visitantes. Se pueden crear todas las que quieras.

Dónde vive cada saldo

Cada moneda elige un provider:

Proveedor	Guarda el saldo en	Uso típico
`internal`	Los datos del jugador del core	Solo para `money`, `tokens` y `gems`
`profile`	El perfil del jugador (JSON o base de datos)	Cualquier moneda nueva: shards, beacons, puntos
`vault`	Otra economía a través de Vault	Usar la economía de otro plugin
`playerpoints`	PlayerPoints	Puntos de tienda
`command`	Otro plugin: el saldo sale de un placeholder y los cambios ejecutan comandos	Cualquier plugin sin API

Los addons pueden registrar más proveedores. Ver Extender PulsePrison.

Opciones

yaml

currencies:
  shards:
    enabled: true
    provider: profile
    name: "Shards"               # plural
    singular: "Shard"
    symbol: "◆"
    color: "&b"
    format: "{color}{symbol} {amount} {name}"
    style: compact               # compact (1.5M), full (1,500,000), integer, plain
    whole-numbers: true          # redondea hacia abajo
    starting-balance: 0          # solo profile
    max-balance: 0               # 0 sin límite, solo profile
    show-in-balance: true        # aparece en /balance
    payable: false               # se puede enviar con /pay
    aliases: [shard]             # otros nombres válidos en comandos y costos

El id (shards) es lo que usan los costos, las acciones, los comandos y los placeholders.

Moneda de otro plugin por comandos

yaml

  coins:
    provider: command
    name: "Coins"
    format: "{color}{amount} {name}"
    balance-placeholder: "%otherplugin_coins%"
    give-command: "coins give {player} {amount}"
    take-command: "coins take {player} {amount}"
    set-command: "coins set {player} {amount}"

Necesita PlaceholderAPI para leer el saldo.

Vault

Con Vault instalado, PulsePrison se registra como la economía del servidor usando money. Las tiendas y otros plugins cobran y pagan sobre ese saldo.

Para hacer lo contrario, usar la economía de otro plugin dentro de PulsePrison, creá una moneda con provider: vault.

Comandos

Comando	Permiso	Hace
`/balance [jugador]`	`pulseprison.balance` · `.others`	Todas las monedas con `show-in-balance`
`/pay <jugador> <cantidad> [moneda]`	`pulseprison.pay`	Envía una moneda con `payable`
`/economy give\|take\|set <jugador> <cantidad> <moneda>`	`pulseprison.admin.economy`	Cambia un saldo
`/economy balance <jugador>`	`pulseprison.admin.economy`	Todos los saldos de un jugador
`/economy top [moneda]`	`pulseprison.admin.economy`	Top 10
`/economy reset <jugador> [moneda]`	`pulseprison.admin.economy`	Reinicia un saldo

Aliases de /economy: /eco, /econ. Las cantidades aceptan sufijos: 1.5K, 2M, 3B.

Placeholders

Placeholder	Ejemplo
`%pulseprison_currency_<id>%`	`1.5M`
`%pulseprison_currency_<id>_formatted%`	`◆ 1.5M Shards`, con el `format` de la moneda
`%pulseprison_currency_<id>_full%`	`1,500,000`
`%pulseprison_currency_<id>_raw%`	`1500000.0`
`%pulseprison_currency_<id>_name%`	`Shards` con su color

Formato de números

Un solo bloque de config.yml decide cómo se escriben los números en mensajes, menús, action bar y placeholders:

yaml

number-format:
  suffixes: ["", "K", "M", "B", "T", "Q", "Qi", "Sx", "Sp", "Oc", "No", "Dc"]
  compact-from: 1000       # por debajo se escribe completo
  decimals:
    small: 2               # 1 a 9.99  -> 1.25K
    medium: 1              # 10 a 99.9 -> 12.5K
    large: 0               # 100 a 999 -> 125K
    below-compact: 1
  trim-zeros: true         # 1.50K se escribe 1.5K
  grouping-separator: ","
  decimal-separator: "."
  money-symbol: "$"
  money-style: compact
  infinity: "∞"

Para escribir los números a la europea, usá grouping-separator: "." y decimal-separator: ",".

Cualquier placeholder numérico de PulsePrison acepta _compact y _commas al final: %pulseprison_tokens_compact%, %pulseprison_tokens_commas%.