RewardBoxes

Este mod añade la capacidad de crear ‘cajas de botín’ aleatorias.

De forma independiente, solo tiene funcionalidades de /comando, pero como API añade la capacidad de activar eventos personalizados para recompensar a los jugadores con una ‘caja de botín’.

Uso:

Todos los siguientes comandos comienzan con “/RewardBox” {Ejemplo: “/RewardBox create ejemplo”}

Comando

Descripción

Permiso

• create <Nombre>

  Crea una nueva RewardBox

  rewardboxes.admin

• add_item <Nombre_RewardBox> <ItemID> <Cantidad> <Probabilidad> add, a

  Agrega un ítem a una RewardBox. El mismo ítem puede ser añadido múltiples veces. ItemID puede ser cualquier ítem: {“Tool_Pickaxe_Crude”}. La probabilidad se representa como: {Probabilidad / Suma(RewardBox.items.chance)}

  rewardboxes.admin

• remove_item <Nombre_RewardBox> <ItemID> rem, r

  Elimina todos los ítems que coincidan con el ItemID. Ejemplo: si tienes una caja con dos “Tool_Pickaxe_Crude”, eliminará ambas entradas de la caja.

  rewardboxes.admin

• grant_item_roll <nombre_jugador> <Nombre_RewardBox> argumento_opcional:<cantidad> add_roll, ar

  Agrega una ‘clave’ al jugador objetivo, lo que le permite abrir la caja especificada <cantidad> de veces. <cantidad> cuando se excluye del comando es 1.

  rewardboxes.admin

• list_boxes list

  Lista todas las cajas y cuántos ítems contienen. “–rewardbox ExampleBox” puede ser usado para listar todos los ítems en una RewardBox.

• roll_box <Nombre_RewardBox> roll, pull

  Si el usuario tiene una ‘clave’ para la RewardBox especificada, se abre la caja y se coloca la recompensa en el inventario del jugador. Si no hay suficiente espacio en el inventario del jugador, el ítem se deja caer en el suelo.

Para Propietarios de Servidores y Modders

Json Config

La primera vez que se lanza este mod, creará un {directorio_raíz_del_servidor}/config/KatsiLib/RewardBoxes.json, este archivo almacena toda la información sobre las RewardBoxes en tu servidor, los comandos se guardan dinámicamente en este archivo, así que si prefieres configurar las RewardBoxes desde dentro del juego, también funciona.

Cuando inicias el mod por primera vez, generará una configuración predeterminada con ejemplos, pero solo si el archivo no existía.

Configuración predeterminada y ejemplo para crear una configuración de RewardBox:

{  
    "is_enabled": true,  
    "reward_boxes": [  
        {  
            "box_creator": "Katsi",  
            "box_name": "DefaultRewardBox",  
            "items": [  
                {  
                    "item_id": "Tool_Pickaxe_Crude",  
                    "pull_chance": 0.5,  
                    "quantity": 1  
                },  
                {  
                    "item_id": "Tool_Hatchet_Crude",  
                    "pull_chance": 0.5,  
                    "quantity": 1  
                }  
            ],  
            "total_chance": 1.0  
        },  
        {  
            "box_creator": "Katsi",  
            "box_name": "ExampleRewardBox",  
            "items": [  
                {  
                    "item_id": "Weapon_Daggers_Crude",  
                    "pull_chance": 35.0,  
                    "quantity": 1  
                },  
                {  
                    "item_id": "Weapon_Daggers_Bone",  
                    "pull_chance": 30.0,  
                    "quantity": 1  
                },  
                {  
                    "item_id": "Weapon_Daggers_Bronze",  
                    "pull_chance": 20.0,  
                    "quantity": 1  
                },  
                {  
                    "item_id": "Weapon_Daggers_Copper",  
                    "pull_chance": 10.0,  
                    "quantity": 1  
                },  
                {  
                    "item_id": "Weapon_Daggers_Iron",  
                    "pull_chance": 5.0,  
                    "quantity": 1  
                }  
            ],  
            "total_chance": 100.0  
        }  
    ]  
}  

Nota: “total_chance” solo necesita ser un número, se calcula al inicio, por lo que su valor no importa.

Modding API

Se publicará más documentación más adelante. Lanzaré un proyecto de ejemplo sobre cómo usar este mod para desarrolladores. – Si deseas comenzar sin dicha documentación, simplemente despacha un GrantRollEvent o ConsumeRollEvent.