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> boolean	Create a boolean CV with default false
/cmdibuzz playerdata create <name> integer	Create an integer CV with 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 boolean
   

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%