refactor: the script code

Author: vytdev

README-curseforge.md doc/curseforge.mdREADME-curseforge.md renamed to doc/curseforge.md

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2023-2025 Vincent Yanzee J. Tan
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

pack/LICENSE

@@ -0,0 +1,13 @@
+This is the core of the debug stick add-on for Minecraft: Bedrock Edition.
+
+Official links:
+- CurseForge: https://www.curseforge.com/minecraft-bedrock/addons/debug-stick
+- MCPEDL: https://mcpedl.com/debug-stick
+- GitHub: https://github.com/vytdev/debug-stick
+
+Last updated: December 21, 2025
+
+Copyright (c) 2023-2025 Vincent Yanzee J. Tan <https://vytdev.github.io>
+This project is licensed under the MIT License.
+This software is provided "as is" without warranty of any kind.
+See LICENSE for the full terms.

pack/README

@@ -0,0 +1,99 @@
+/*!
+ * Debug Stick -- A Bedrock port of the debug stick tool from Java Edition.
+ * Copyright (c) 2023-2025 Vincent Yanzee J. Tan <https://vytdev.github.io>
+ *
+ * This project is licensed under the MIT License.
+ * This software is provided "as is" without warranty of any kind.
+ * See LICENSE for the full terms.
+ */
+
+import { Block, Player } from '@minecraft/server';
+import { message } from './utils.js';
+import { getStatesOfBlock, getStateValidValues, setBlockState
+    } from './state.js';
+import { DebugStateSelections } from './selection.js';
+
+
+/**
+ * Change the selected block state.
+ * @param player The player who initiated the change.
+ * @param block The block the player is working with.
+ * @param item The debug stick item used.
+ */
+export function changeSelectedProperty(player: Player, block: Block) {
+  const states = getStatesOfBlock(block);
+  const stateNames = Object.keys(states);
+  if (!stateNames.length)
+    return message(`${block.typeId} has no properties`, player);
+
+  // Cycle through the possible states.
+  const selections = new DebugStateSelections(player.id);
+  let currState = selections.getSelectedStateForBlock(block.typeId);
+  currState = stateNames[(stateNames.indexOf(currState) + 1)
+      % stateNames.length];
+  selections.setSelectedStateForBlock(block.typeId, currState);
+
+  message(`selected "${currState}" (${states[currState]})`, player);
+}
+
+
+/**
+ * Cycle the state value of the selected state on a block.
+ * @param player The player who initiated the cycle.
+ * @param block The block to update with the debug stick.
+ * @param item The debug stick item used.
+ */
+export function updateBlockProperty(player: Player, block: Block) {
+  const states = getStatesOfBlock(block);
+  const stateNames = Object.keys(states);
+  if (!stateNames.length)
+    return message(`${block.typeId} has no properties`, player);
+
+  // Get the currently selected state.
+  const selections = new DebugStateSelections(player.id);
+  const currState = selections.getSelectedStateForBlock(block.typeId)
+      ?? stateNames[0];
+
+  // Cycle through valid state values.
+  const valids = getStateValidValues(currState);
+  const value = valids[(valids.indexOf(states[currState]) + 1) % valids.length];
+
+  setBlockState(block, currState, value)
+    .then(() => message(`"${currState}" to ${value}`, player));
+}
+
+
+/**
+ * The block viewer feature
+ * @param player
+ * @param block
+ */
+export function displayBlockInfo(player: Player, block: Block) {
+  let info = '§l§b' + block.typeId + '§r';
+
+  // Basic block info.
+  info += '\n§4' + block.x + ' §a' + block.y + ' §9' + block.z;
+  info += '\n§7matter state§8: §e';
+  if (block.isLiquid)   info += 'liquid';
+  else if (block.isAir) info += 'gas';
+  else                  info += 'solid';
+  //info += '\n§7hard block§8: ' + (block.isSolid ? '§ayes' : '§cno');
+  info += '\n§7redstone power§8: §c' + (block.getRedstonePower() ?? 0);
+
+  // The set block states.
+  for (const [stateName, value] of Object.entries(getStatesOfBlock(block))) {
+    info += '\n§o§7' + stateName + '§r§8: ';
+    switch (typeof value) {
+      case 'string':  info += '§e'; break;
+      case 'number':  info += '§3'; break;
+      case 'boolean': info += '§6'; break;
+      default:        info += '§8';
+    }
+    info += value;
+  };
+
+  // Additional block tags.
+  block.getTags().forEach(v => info += '\n§d#' + v);
+
+  message(info, player);
+}