This is a mod for Hytale.

This mod adds the ability to create random 'loot-boxes'.

Standalone it only has /command functionalities, but as a api it adds the ability to trigger custom events to reward players with a 'loot-box'.

Usage:

All of the following commands start with “/RewardBox” {Example: “/RewardBox create example”}

For Server Owners & Modders

Json Config

The first time this mod launches it will create a {server_root_directory}/config/KatsiLib/RewardBoxes.json, this file stores all the information about the RewardBoxes on your server, the commands dynamically save to this file so if you prefer to setup RewardBoxes from within the game then that works too.

When you first launch the mod it will generate a default config with examples, but only if the file didn't exist.

Default & Example for creating an RewardBox config:

{  
    "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  
        }  
    ]  
}  

Note: “total_chance” just needs to be a number, it is calculated on startup so its value does not matter.

Modding API

An example mod that uses this mods API is my 'DailyLoginReward'. The source code is available on github for futher reference.

To interact with this mods API you use Hytales built in event system, this mod had 2 events tied to it, GrantRollEvent() and the ConsumeRollEvent(), both of these events have the same signature "new GrantRollEvent(PlayerRef targetted_player, String RewardBoxName, int Number_Keys_To_Give);"

The GrantRollEvent gives 'keys' to the targeted player to be able to open specified RewardBoxes. The ConsumeRollEvent causes the targeted player to attempt to roll a RewardBox X amount of times. Note: The user will consume their keys to open these boxes and will stop once they run out of keys. {Example: I have 4 keys -> Event(Me, ExampleBox, 6) -> 4 rolls will happen and I will have 0 keys left over.}

The code to dispatch an event is typically:

IEventDispatcher<GrantRollEvent, GrantRollEvent> dispatcher = HytaleServer.get().getEventBus().dispatchFor(GrantRollEvent.class); if (dispatcher.hasListener()) { GrantRollEvent event = new GrantRollEvent(playerRef, reward_box, num_keys_to_give); dispatcher.dispatch(event); }