Cmdibuzz Custom Variables

Overview

Custom Variables (CVs) are user-defined, per-player data values stored in the SQLite database. They can be integers (default) or booleans.

Admin Commands

All commands require OP level 4.

| Command | Description | |---|---| | /cmdibuzz playerdata list | List all defined custom variables with their types | | /cmdibuzz playerdata create <name> bool:true | Create a boolean CV with default true | | /cmdibuzz playerdata create <name> bool:false | Create a boolean CV with default false | | /cmdibuzz playerdata create <name> | Create an integer CV (default 0) | | /cmdibuzz playerdata delete <name> | Delete a CV and all player values for it | | /cmdibuzz playerdata set <name> <value> <player> | Set a CV value | | /cmdibuzz playerdata add <name> <amount> <player> | Increment an integer CV | | /cmdibuzz playerdata minus <name> <amount> <player> | Decrement an integer CV | | /cmdibuzz playerdata check <name> <player> | Check a player's CV value |

Usage in Commands

Reference CVs in any action or script condition:

Condition Check

$Script$%if%%PlayerData%$rep_points>49

Set via Command

$run_console$cmdibuzz playerdata set dungeon_points 100 $player

Example: Dungeon Points System

1. Create the variable:

   /cmdibuzz playerdata create dungeon_points
   

2. Give points after completing a floor:

   /cmdibuzz playerdata add dungeon_points 1 <player>
   

3. Use in a command:

   runcmd:
     - $Script$%if%%PlayerData%$dungeon_points>4
     - text: <green>You have enough points to enter the boss room!
     - $run_console$cmdibuzz playerdata set dungeon_points 0 $player
     - $Script$%else%
     - text: <red>You need at least 5 dungeon points!
     - $Script$%endif%
   

Example: Boolean Flag

1. Create a boolean CV:

   /cmdibuzz playerdata create has_quest_item bool:true
   

2. Set when player receives the item:

   /cmdibuzz playerdata set has_quest_item true <player>
   

3. Check in a command:

   runcmd:
     - $Script$%if%%PlayerData%$has_quest_item==true
     - $run_console$give $player minecraft:nether_star 1
     - text: <green>You hand over the quest item and receive a star!
     - $run_console$cmdibuzz playerdata set has_quest_item false $player
     - $Script$%else%
     - text: <red>You don't have the quest item!
     - $Script$%endif%