redscript-mc 1.2.27 → 1.2.29

package/README.md

@@ -2,14 +2,14 @@
 
 <img src="./logo.png" alt="RedScript Logo" width="64" />
 
-<img src="https://img.shields.io/badge/RedScript-1.2.26-red?style=for-the-badge&logo=minecraft&logoColor=white" alt="RedScript" />
+<img src="https://img.shields.io/badge/RedScript-1.2.27-red?style=for-the-badge&logo=minecraft&logoColor=white" alt="RedScript" />
 
 **A typed scripting language that compiles to Minecraft datapacks.**
 
 Write clean game logic. RedScript handles the scoreboard spaghetti.
 
 [![CI](https://github.com/bkmashiro/redscript/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/bkmashiro/redscript/actions/workflows/ci.yml)
-[![Tests](https://img.shields.io/badge/tests-917%20passing-brightgreen)](https://github.com/bkmashiro/redscript)
+[![Tests](https://img.shields.io/badge/tests-918%20passing-brightgreen)](https://github.com/bkmashiro/redscript)
 [![npm](https://img.shields.io/npm/v/redscript-mc?color=cb3837)](https://www.npmjs.com/package/redscript-mc)
 [![npm downloads](https://img.shields.io/npm/dm/redscript-mc?color=cb3837)](https://www.npmjs.com/package/redscript-mc)
 [![VSCode](https://img.shields.io/badge/VSCode-Extension-007ACC?logo=visualstudiocode)](https://marketplace.visualstudio.com/items?itemName=bkmashiro.redscript-vscode)
@@ -76,17 +76,6 @@ fn stop() {
 
 ---
 
-### What's New in v1.2.26
-
-- **Math stdlib** (`math.mcrs`): 18 fixed-point functions — `abs`, `sign`, `min`, `max`, `clamp`, `lerp`, `isqrt`, `sqrt_fixed`, `pow_int`, `gcd`, `lcm`, `sin_fixed`, `cos_fixed`, `map`, `ceil_div`, `log2_int`, `mulfix`, `divfix`, `smoothstep`, `smootherstep`
-- **Vector stdlib** (`vec.mcrs`): 2D and 3D geometry — dot/cross products, `length2d_fixed`, `atan2_fixed` (binary search, O(log 46)), `normalize2d`, `rotate2d`, `lerp2d`, full 3D cross product
-- **Advanced stdlib** (`advanced.mcrs`): number theory (`fib`, `is_prime`, `collatz_steps`, `gcd`, `mod_pow`), hash/noise (`hash_int` splitmix32, `noise1d`), curves (`bezier_quad`), fractals (`mandelbrot_iter`, `julia_iter`), geometry experiments
-- **BigInt** (`bigint.mcrs`): arbitrary precision integers — base 10,000 × 8 limbs = up to 32 decimal digits; `bigint_add/sub/compare/mul/fib` running on MC scoreboard + NBT storage
-- **`module library;` pragma**: declare a file as a library; functions are tree-shaken out unless called — stdlib never bloats your pack
-- **`storage_get_int` / `storage_set_int` builtins**: dynamic NBT int array read/write with runtime indices via MC 1.20.2 macro sub-functions
-- **`@require_on_load(fn)` decorator**: declarative load-time dependency tracking for stdlib initializers (sin/cos table setup etc.)
-- **Compiler fixes**: `isqrt` large-number convergence, optimizer copy propagation alias invalidation, cross-function variable collision, MCRuntime array-index regex
-
 ### What's New in v1.2.25
 
 - `impl` blocks and methods for object-style APIs on structs
@@ -343,8 +332,30 @@ fn show_fib() {
 
 ---
 
+### What's New in v1.2.27
+
+- **BigInt confirmed working in real Minecraft** (`bigint.mcrs`): arbitrary precision integers on MC scoreboard + NBT — base 10,000 × 8 limbs = up to 32 decimal digits; `bigint_add`, `bigint_sub`, `bigint_compare`, `bigint_mul`, `bigint_fib(50)` = 12,586,269,025 all verified on Paper 1.21.4
+- **`storage_set_int` macro fix**: dynamic NBT array writes now use `execute store result storage` instead of `data modify set value $(n)` — avoids a silent Minecraft macro substitution bug with integer values
+- **Full stdlib** (`math.mcrs`, `vec.mcrs`, `advanced.mcrs`, `bigint.mcrs`, `showcase.mcrs`): 18 math functions, 14 vector geometry functions, 20+ advanced number-theory and fractal functions
+- **`module library;` pragma**: tree-shaking for library files — stdlib never bloats your pack
+- **`storage_get_int` / `storage_set_int` builtins**: dynamic NBT int array read/write with runtime indices via MC 1.20.2+ macro sub-functions
+- **`@require_on_load(fn)` decorator**: declarative load-time dependency tracking for sin/cos/atan table initializers
+
+### What's New in v1.2.26
+
+- **Math stdlib** (`math.mcrs`): 18 fixed-point functions — `abs`, `sign`, `min`, `max`, `clamp`, `lerp`, `isqrt`, `sqrt_fixed`, `pow_int`, `gcd`, `lcm`, `sin_fixed`, `cos_fixed`, `map`, `ceil_div`, `log2_int`, `mulfix`, `divfix`, `smoothstep`, `smootherstep`
+- **Vector stdlib** (`vec.mcrs`): 2D and 3D geometry — dot/cross products, `length2d_fixed`, `atan2_fixed` (binary search, O(log 46)), `normalize2d`, `rotate2d`, `lerp2d`, full 3D cross product
+- **Advanced stdlib** (`advanced.mcrs`): number theory (`fib`, `is_prime`, `collatz_steps`, `gcd`, `mod_pow`), hash/noise (`hash_int` splitmix32, `noise1d`), curves (`bezier_quad`), fractals (`mandelbrot_iter`, `julia_iter`), geometry experiments
+- **BigInt** (`bigint.mcrs`): arbitrary precision integers — base 10,000 × 8 limbs = up to 32 decimal digits; `bigint_add/sub/compare/mul/fib` running on MC scoreboard + NBT storage
+- **Compiler fixes**: `isqrt` large-number convergence, optimizer copy propagation alias invalidation, cross-function variable collision, MCRuntime array-index regex
+
 ### Changelog Highlights
 
+#### v1.2.27 (2026-03-14)
+
+- **BigInt real-MC fix**: `storage_set_int` macro now uses `execute store result storage` instead of `data modify set value $(n)` — avoids a Minecraft macro substitution bug with integer values; BigInt confirmed working on Paper 1.21.4
+- **showcase**: `atan2_fixed` returns degrees (0–360), not millidegrees; fixed over-division in examples; `mod_pow` test cases use small safe-range moduli (no INT32 overflow)
+
 #### v1.2.26 (2026-03-14)
 
 - Full math/vector/advanced/bigint standard library (see above)

package/README.zh.md

@@ -2,14 +2,14 @@
 
 <img src="./logo.png" alt="RedScript Logo" width="64" />
 
-<img src="https://img.shields.io/badge/RedScript-1.2.26-red?style=for-the-badge&logo=minecraft&logoColor=white" alt="RedScript" />
+<img src="https://img.shields.io/badge/RedScript-1.2.27-red?style=for-the-badge&logo=minecraft&logoColor=white" alt="RedScript" />
 
 **一个编译到 Minecraft Datapack 的类型化脚本语言。**
 
 写干净的游戏逻辑，把记分板的面条代码交给 RedScript 处理。
 
 [![CI](https://github.com/bkmashiro/redscript/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/bkmashiro/redscript/actions/workflows/ci.yml)
-[![Tests](https://img.shields.io/badge/tests-917%20passing-brightgreen)](https://github.com/bkmashiro/redscript)
+[![Tests](https://img.shields.io/badge/tests-918%20passing-brightgreen)](https://github.com/bkmashiro/redscript)
 [![npm](https://img.shields.io/npm/v/redscript-mc?color=cb3837)](https://www.npmjs.com/package/redscript-mc)
 [![npm downloads](https://img.shields.io/npm/dm/redscript-mc?color=cb3837)](https://www.npmjs.com/package/redscript-mc)
 [![VSCode](https://img.shields.io/badge/VSCode-插件-007ACC?logo=visualstudiocode)](https://marketplace.visualstudio.com/items?itemName=bkmashiro.redscript-vscode)
@@ -73,14 +73,20 @@ let running: bool = false;
 
 ---
 
+### v1.2.27 新增内容
+
+- **BigInt 实机验证通过** (`bigint.mcrs`)：任意精度整数在 MC 记分板 + NBT 上完整运行 — base 10000 × 8 limbs = 最多 32 位十进制数；`bigint_fib(50)` = 12,586,269,025 在 Paper 1.21.4 实机验证正确
+- **`storage_set_int` 宏修复**：动态 NBT 数组写入改用 `execute store result storage` 而非 `data modify set value $(n)` — 规避 Minecraft 宏机制对整数值的静默替换 bug
+- **完整标准库** (`math.mcrs`、`vec.mcrs`、`advanced.mcrs`、`bigint.mcrs`、`showcase.mcrs`)：18 个数学函数、14 个向量几何函数、20+ 数论与分形函数
+- **`module library;` pragma**：库文件零成本树摇 — 标准库永远不会撑大你的数据包
+- **`@require_on_load(fn)` 装饰器**：sin/cos/atan 查找表初始化器的声明式加载依赖跟踪
+
 ### v1.2.26 新增内容
 
 - **数学标准库** (`math.mcrs`)：18 个定点数函数 — `abs`、`sign`、`min`、`max`、`clamp`、`lerp`、`isqrt`、`sqrt_fixed`、`pow_int`、`gcd`、`lcm`、`sin_fixed`、`cos_fixed`、`map`、`ceil_div`、`log2_int`、`mulfix`、`divfix`、`smoothstep`、`smootherstep`
 - **向量标准库** (`vec.mcrs`)：2D / 3D 几何 — 点积/叉积、`length2d_fixed`、`atan2_fixed`（二分搜索正切表，O(log 46)）、`normalize2d`、`rotate2d`、`lerp2d`、完整 3D 叉积
 - **高级标准库** (`advanced.mcrs`)：数论（`fib`、`is_prime`、`collatz_steps`、`mod_pow`）、哈希/噪声（splitmix32 `hash_int`、`noise1d`）、曲线（`bezier_quad`）、分形（`mandelbrot_iter`、`julia_iter`）、几何实验
-- **BigInt** (`bigint.mcrs`)：任意精度整数 — base 10000 × 8 limbs = 最多 32 位十进制数；`bigint_add/sub/compare/mul/fib` 全部运行在 MC 记分板 + NBT storage 上
-- **`module library;` pragma**：将文件声明为库，未被调用的函数会被树摇消除 — 标准库永远不会撑大你的数据包
-- **`storage_get_int` / `storage_set_int` 内置函数**：通过 MC 1.20.2 宏子函数实现动态 NBT int 数组读写
+- **BigInt** (`bigint.mcrs`)：任意精度整数架构设计 — base 10000 × 8 limbs = 最多 32 位十进制数
 - **编译器修复**：`isqrt` 大数收敛、优化器拷贝传播别名失效、跨函数变量命名冲突、MCRuntime 数组索引正则
 
 ### v1.2.25 新增内容
@@ -337,6 +343,11 @@ fn show_fib() {
 
 ### 更新日志亮点
 
+#### v1.2.27（2026-03-14）
+
+- **BigInt 实机修复**：`storage_set_int` 宏改用 `execute store result storage`，规避 MC 宏整数替换 bug；BigInt 在 Paper 1.21.4 实机验证通过
+- showcase 示例修复：`atan2_fixed` 返回度数（0–360），更正不必要的除以 1000；`mod_pow` 测试改用小 modulus 避免 INT32 溢出
+
 #### v1.2.26（2026-03-14）
 
 - 完整的数学/向量/高级/BigInt 标准库（详见上方）

package/dist/__tests__/cli.test.js

@@ -77,7 +77,7 @@ describe('CLI API', () => {
             const source = fs.readFileSync(mainPath, 'utf-8');
             const result = (0, index_1.compile)(source, { namespace: 'mygame', filePath: mainPath });
             const tickTimer = result.files.find(file => file.path.endsWith('/tick_timer.mcfunction'));
-            expect(tickTimer?.content).toContain('scoreboard players set #rs rs.timer_ticks 1');
+            expect(tickTimer?.content).toContain('scoreboard players set #rs __mygame.timer_ticks 1');
         });
         it('adds a call-site hash for stdlib internal scoreboard objectives', () => {
             const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'redscript-stdlib-hash-'));
@@ -106,7 +106,7 @@ describe('CLI API', () => {
             const timerFns = result.files.filter(file => /timer_start__callsite_[0-9a-f]{4}\.mcfunction$/.test(file.path));
             expect(timerFns).toHaveLength(2);
             const objectives = timerFns
-                .flatMap(file => [...file.content.matchAll(/rs\._timer_([0-9a-f]{4})/g)].map(match => match[0]));
+                .flatMap(file => [...file.content.matchAll(/mygame\._timer_([0-9a-f]{4})/g)].map(match => match[0]));
             expect(new Set(objectives).size).toBe(2);
         });
         it('Timer::new creates timer', () => {
@@ -125,8 +125,8 @@ describe('CLI API', () => {
             const result = (0, index_1.compile)(source, { namespace: 'timernew', filePath: mainPath });
             expect(result.typeErrors).toEqual([]);
             const newFn = result.files.find(file => file.path.endsWith('/Timer_new.mcfunction'));
-            expect(newFn?.content).toContain('scoreboard players set timer_ticks rs 0');
-            expect(newFn?.content).toContain('scoreboard players set timer_active rs 0');
+            expect(newFn?.content).toContain('scoreboard players set timer_ticks __timernew 0');
+            expect(newFn?.content).toContain('scoreboard players set timer_active __timernew 0');
         });
         it('Timer.start/pause/reset', () => {
             const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'redscript-timer-state-'));
@@ -149,9 +149,9 @@ describe('CLI API', () => {
             const startFn = result.files.find(file => file.path.endsWith('/Timer_start.mcfunction'));
             const pauseFn = result.files.find(file => file.path.endsWith('/Timer_pause.mcfunction'));
             const resetFn = result.files.find(file => file.path.endsWith('/Timer_reset.mcfunction'));
-            expect(startFn?.content).toContain('scoreboard players set timer_active rs 1');
-            expect(pauseFn?.content).toContain('scoreboard players set timer_active rs 0');
-            expect(resetFn?.content).toContain('scoreboard players set timer_ticks rs 0');
+            expect(startFn?.content).toContain('scoreboard players set timer_active __timerstate 1');
+            expect(pauseFn?.content).toContain('scoreboard players set timer_active __timerstate 0');
+            expect(resetFn?.content).toContain('scoreboard players set timer_ticks __timerstate 0');
         });
         it('Timer.done returns bool', () => {
             const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'redscript-timer-done-'));
@@ -174,9 +174,9 @@ describe('CLI API', () => {
             expect(result.typeErrors).toEqual([]);
             const doneFn = result.files.find(file => file.path.endsWith('/Timer_done.mcfunction'));
             const mainFn = result.files.find(file => file.path.endsWith('/main.mcfunction'));
-            expect(doneFn?.content).toContain('scoreboard players get timer_ticks rs');
+            expect(doneFn?.content).toContain('scoreboard players get timer_ticks __timerdone');
             expect(doneFn?.content).toContain('return run scoreboard players get');
-            expect(mainFn?.content).toContain('execute if score $main_finished rs matches 1..');
+            expect(mainFn?.content).toContain('execute if score $main_finished __timerdone matches 1..');
         });
         it('Timer.tick increments', () => {
             const tempDir = fs.mkdtempSync(path.join(os.tmpdir(), 'redscript-timer-tick-'));
@@ -199,10 +199,10 @@ describe('CLI API', () => {
                 .filter(file => file.path.includes('/Timer_tick'))
                 .map(file => file.content)
                 .join('\n');
-            expect(tickOutput).toContain('scoreboard players get timer_active rs');
-            expect(tickOutput).toContain('scoreboard players get timer_ticks rs');
-            expect(tickOutput).toContain(' += $const_1 rs');
-            expect(tickOutput).toContain('execute store result score timer_ticks rs run scoreboard players get $_');
+            expect(tickOutput).toContain('scoreboard players get timer_active __timertick');
+            expect(tickOutput).toContain('scoreboard players get timer_ticks __timertick');
+            expect(tickOutput).toContain(' += $const_1 __timertick');
+            expect(tickOutput).toContain('execute store result score timer_ticks __timertick run scoreboard players get $_');
         });
     });
     describe('compile()', () => {

package/dist/__tests__/optimizer-advanced.test.js

@@ -26,7 +26,7 @@ fn turret_tick() {
         const result = (0, index_1.compile)(source, { namespace: 'test' });
         const parent = getFileContent(result.files, 'data/test/function/turret_tick.mcfunction');
         const loopBody = getFileContent(result.files, 'data/test/function/turret_tick/foreach_0.mcfunction');
-        const hoistedRead = 'execute store result score $_0 rs run scoreboard players get config test.turret_range';
+        const hoistedRead = 'execute store result score $_0 __test run scoreboard players get config test.turret_range';
         const executeCall = 'execute as @e[tag=turret] run function test:turret_tick/foreach_0';
         expect(parent).toContain(hoistedRead);
         expect(parent.indexOf(hoistedRead)).toBeLessThan(parent.indexOf(executeCall));
@@ -48,7 +48,7 @@ fn read_twice() {
         const fn = getFileContent(result.files, 'data/test/function/read_twice.mcfunction');
         const readMatches = fn.match(/scoreboard players get @s test\.coins/g) ?? [];
         expect(readMatches).toHaveLength(1);
-        expect(fn).toContain('scoreboard players operation $_1 rs = $_0 rs');
+        expect(fn).toContain('scoreboard players operation $_1 __test = $_0 __test');
     });
     test('reuses duplicate arithmetic sequences', () => {
         const source = `
@@ -63,9 +63,9 @@ fn math() {
 `;
         const result = (0, index_1.compile)(source, { namespace: 'test' });
         const fn = getFileContent(result.files, 'data/test/function/math.mcfunction');
-        const addMatches = fn.match(/\+= \$const_2 rs/g) ?? [];
+        const addMatches = fn.match(/\+= \$const_2 __test/g) ?? [];
         expect(addMatches).toHaveLength(1);
-        expect(fn).toContain('scoreboard players operation $_1 rs = $_0 rs');
+        expect(fn).toContain('scoreboard players operation $_1 __test = $_0 __test');
     });
 });
 describe('setblock batching', () => {

package/dist/cli.js

@@ -60,7 +60,7 @@ function printUsage() {
 RedScript Compiler
 
 Usage:
-  redscript compile <file> [-o <out>] [--output-nbt <file>] [--namespace <ns>] [--target <target>] [--no-dce]
+  redscript compile <file> [-o <out>] [--output-nbt <file>] [--namespace <ns>] [--scoreboard <obj>] [--target <target>] [--no-dce]
   redscript watch <dir> [-o <outdir>] [--namespace <ns>] [--hot-reload <url>]
   redscript check <file>
   redscript fmt <file.mcrs> [file2.mcrs ...]
@@ -85,6 +85,9 @@ Options:
   --target <target>      Output target: datapack (default), cmdblock, or structure
   --no-dce               Disable AST dead code elimination
   --no-mangle            Disable variable name mangling (use readable names)
+  --scoreboard <obj>     Scoreboard objective for variables (default: namespace).
+                         Each datapack automatically uses its namespace as the objective
+                         so multiple datapacks can coexist without collisions.
   --stats                Print optimizer statistics
   --hot-reload <url>     After each successful compile, POST to <url>/reload
                          (use with redscript-testharness; e.g. http://localhost:25561)
@@ -218,6 +221,10 @@ function parseArgs(args) {
             result.mangle = false;
             i++;
         }
+        else if (arg === '--scoreboard') {
+            result.scoreboardObjective = args[++i];
+            i++;
+        }
         else if (arg === '--hot-reload') {
             result.hotReload = args[++i];
             i++;
@@ -271,7 +278,7 @@ function printOptimizationStats(stats) {
     console.log(`  constant folding: ${stats.constantFolds} constants folded`);
     console.log(`  Total mcfunction commands: ${stats.totalCommandsBefore} -> ${stats.totalCommandsAfter} (${formatReduction(stats.totalCommandsBefore, stats.totalCommandsAfter)} reduction)`);
 }
-function compileCommand(file, output, namespace, target = 'datapack', showStats = false, dce = true, mangle = true) {
+function compileCommand(file, output, namespace, target = 'datapack', showStats = false, dce = true, mangle = true, scoreboardObjective = undefined) {
     // Read source file
     if (!fs.existsSync(file)) {
         console.error(`Error: File not found: ${file}`);
@@ -280,7 +287,7 @@ function compileCommand(file, output, namespace, target = 'datapack', showStats
     const source = fs.readFileSync(file, 'utf-8');
     try {
         if (target === 'cmdblock') {
-            const result = (0, index_1.compile)(source, { namespace, filePath: file, dce, mangle });
+            const result = (0, index_1.compile)(source, { namespace, filePath: file, dce, mangle, scoreboardObjective });
             printWarnings(result.warnings);
             // Generate command block JSON
             const hasTick = result.files.some(f => f.path.includes('__tick.mcfunction'));
@@ -309,7 +316,7 @@ function compileCommand(file, output, namespace, target = 'datapack', showStats
             }
         }
         else {
-            const result = (0, index_1.compile)(source, { namespace, filePath: file, dce, mangle });
+            const result = (0, index_1.compile)(source, { namespace, filePath: file, dce, mangle, scoreboardObjective });
             printWarnings(result.warnings);
             // Default: generate datapack
             // Create output directory
@@ -483,7 +490,8 @@ async function main() {
                 const output = target === 'structure'
                     ? (parsed.outputNbt ?? parsed.output ?? `./${namespace}.nbt`)
                     : (parsed.output ?? './dist');
-                compileCommand(parsed.file, output, namespace, target, parsed.stats, parsed.dce, parsed.mangle);
+                compileCommand(parsed.file, output, namespace, target, parsed.stats, parsed.dce, parsed.mangle, parsed.scoreboardObjective // undefined = derive from namespace in compile()
+                );
             }
             break;
         case 'watch':

package/dist/codegen/mcfunction/index.d.ts

@@ -30,6 +30,10 @@ export interface DatapackGenerationResult {
 export interface DatapackGenerationOptions {
     optimizeCommands?: boolean;
     mangle?: boolean;
+    /** Scoreboard objective used for all scoreboard variables.
+     *  Defaults to 'rs'. Override per-datapack to avoid collisions
+     *  when multiple RedScript datapacks are loaded simultaneously. */
+    scoreboardObjective?: string;
 }
 export declare function countMcfunctionCommands(files: DatapackFile[]): number;
 export declare function generateDatapackWithStats(module: IRModule, options?: DatapackGenerationOptions): DatapackGenerationResult;

package/dist/codegen/mcfunction/index.js

@@ -26,7 +26,8 @@ const var_allocator_1 = require("../var-allocator");
 // ---------------------------------------------------------------------------
 // Utilities
 // ---------------------------------------------------------------------------
-const OBJ = 'rs'; // scoreboard objective name
+// Default scoreboard objective — overridden per-compilation via DatapackGenerationOptions.scoreboardObjective
+let OBJ = 'rs';
 function operandToScore(op, alloc) {
     if (op.kind === 'var')
         return `${alloc.alloc(op.name)} ${OBJ}`;
@@ -335,7 +336,11 @@ function preAllocTerm(term, alloc) {
     }
 }
 function generateDatapackWithStats(module, options = {}) {
-    const { optimizeCommands = true, mangle = false } = options;
+    const { optimizeCommands = true, mangle = false, scoreboardObjective = 'rs' } = options;
+    // Set module-level OBJ so all helper functions in this module use the correct objective.
+    // This is safe because compilation is synchronous.
+    OBJ = scoreboardObjective;
+    (0, commands_1.setOptimizerObjective)(scoreboardObjective);
     const alloc = new var_allocator_1.VarAllocator(mangle);
     const files = [];
     const advancements = [];
@@ -375,10 +380,10 @@ function generateDatapackWithStats(module, options = {}) {
     for (const eventType of eventTypes) {
         const detection = types_1.EVENT_TYPES[eventType].detection;
         if (eventType === 'PlayerDeath') {
-            loadLines.push('scoreboard objectives add rs.deaths deathCount');
+            loadLines.push(`scoreboard objectives add ${OBJ}.deaths deathCount`);
         }
         else if (eventType === 'EntityKill') {
-            loadLines.push('scoreboard objectives add rs.kills totalKillCount');
+            loadLines.push(`scoreboard objectives add ${OBJ}.kills totalKillCount`);
         }
         else if (eventType === 'ItemUse') {
             loadLines.push('# ItemUse detection requires a project-specific objective/tag setup');

package/dist/compile.d.ts

@@ -13,6 +13,11 @@ export interface CompileOptions {
     optimize?: boolean;
     dce?: boolean;
     mangle?: boolean;
+    /** Scoreboard objective used for all variable slots.
+     *  Defaults to '__<namespace>' (e.g. '__mathshow') — the double-underscore
+     *  prefix signals compiler-internal and avoids occupying the user's namespace.
+     *  Each datapack gets a unique objective automatically; no manual setup needed. */
+    scoreboardObjective?: string;
     /** Additional source files that should be treated as *library* code.
      *  Functions in these files are DCE-eligible: they are only compiled into
      *  the datapack when actually called from user code.  Each string is parsed

package/dist/compile.js

@@ -209,6 +209,11 @@ function compile(source, options = {}) {
         }
         const dceResult = shouldRunDce ? (0, dce_1.eliminateDeadCode)(parsedAst) : { program: parsedAst, warnings: [] };
         const ast = dceResult.program;
+        // Configure scoreboard objective for this compilation.
+        // Default: use the datapack namespace so each datapack gets its own objective
+        // automatically, preventing variable collisions when multiple datapacks coexist.
+        const scoreboardObj = options.scoreboardObjective ?? `__${namespace}`;
+        (0, lowering_1.setScoreboardObjective)(scoreboardObj);
         // Lowering
         const ir = new lowering_1.Lowering(namespace, preprocessed.ranges).lower(ast);
         // Optimization
@@ -217,7 +222,10 @@ function compile(source, options = {}) {
             : ir;
         // Code generation — mangle=true by default to prevent cross-function
         // scoreboard variable collisions in the global MC scoreboard namespace.
-        const generated = (0, mcfunction_1.generateDatapackWithStats)(optimized, { mangle: options.mangle ?? true });
+        const generated = (0, mcfunction_1.generateDatapackWithStats)(optimized, {
+            mangle: options.mangle ?? true,
+            scoreboardObjective: scoreboardObj,
+        });
         return {
             success: true,
             files: [...generated.files, ...generated.advancements],

package/dist/index.d.ts

@@ -17,6 +17,11 @@ export interface CompileOptions {
     filePath?: string;
     dce?: boolean;
     mangle?: boolean;
+    /** Scoreboard objective used for all variable slots.
+     *  Defaults to '__<namespace>' (e.g. '__mathshow') to avoid collisions when
+     *  multiple RedScript datapacks are loaded simultaneously, without occupying
+     *  the user's own namespace. Override only if you need a specific name. */
+    scoreboardObjective?: string;
 }
 export interface CompileResult {
     files: DatapackFile[];

package/dist/index.js

@@ -66,11 +66,16 @@ function compile(source, options = {}) {
         const checker = new typechecker_1.TypeChecker(preprocessedSource, filePath);
         typeErrors = checker.check(ast);
     }
+    // Configure scoreboard objective for this compilation.
+    // Default: use the datapack namespace so each datapack gets its own objective
+    // automatically, preventing variable collisions when multiple datapacks coexist.
+    const scoreboardObj = options.scoreboardObjective ?? `__${namespace}`;
+    (0, lowering_1.setScoreboardObjective)(scoreboardObj);
     // Lowering to IR
     const lowering = new lowering_1.Lowering(namespace, preprocessed.ranges);
     const ir = lowering.lower(ast);
     let optimizedIR = ir;
-    let generated = (0, mcfunction_1.generateDatapackWithStats)(ir, { optimizeCommands: shouldOptimize, mangle });
+    let generated = (0, mcfunction_1.generateDatapackWithStats)(ir, { optimizeCommands: shouldOptimize, mangle, scoreboardObjective: scoreboardObj });
     let optimizationStats;
     if (shouldOptimize) {
         const stats = (0, commands_1.createEmptyOptimizationStats)();
@@ -86,10 +91,10 @@ function compile(source, options = {}) {
         }
         const copyPropagatedIR = { ...ir, functions: copyPropagatedFunctions };
         optimizedIR = { ...ir, functions: deadCodeEliminatedFunctions };
-        const baselineGenerated = (0, mcfunction_1.generateDatapackWithStats)(ir, { optimizeCommands: false, mangle });
-        const beforeDceGenerated = (0, mcfunction_1.generateDatapackWithStats)(copyPropagatedIR, { optimizeCommands: false, mangle });
-        const afterDceGenerated = (0, mcfunction_1.generateDatapackWithStats)(optimizedIR, { optimizeCommands: false, mangle });
-        generated = (0, mcfunction_1.generateDatapackWithStats)(optimizedIR, { optimizeCommands: true, mangle });
+        const baselineGenerated = (0, mcfunction_1.generateDatapackWithStats)(ir, { optimizeCommands: false, mangle, scoreboardObjective: scoreboardObj });
+        const beforeDceGenerated = (0, mcfunction_1.generateDatapackWithStats)(copyPropagatedIR, { optimizeCommands: false, mangle, scoreboardObjective: scoreboardObj });
+        const afterDceGenerated = (0, mcfunction_1.generateDatapackWithStats)(optimizedIR, { optimizeCommands: false, mangle, scoreboardObjective: scoreboardObj });
+        generated = (0, mcfunction_1.generateDatapackWithStats)(optimizedIR, { optimizeCommands: true, mangle, scoreboardObjective: scoreboardObj });
         stats.deadCodeRemoved =
             (0, mcfunction_1.countMcfunctionCommands)(beforeDceGenerated.files) - (0, mcfunction_1.countMcfunctionCommands)(afterDceGenerated.files);
         stats.licmHoists = generated.stats.licmHoists;
@@ -105,7 +110,7 @@ function compile(source, options = {}) {
     }
     else {
         optimizedIR = ir;
-        generated = (0, mcfunction_1.generateDatapackWithStats)(ir, { optimizeCommands: false, mangle });
+        generated = (0, mcfunction_1.generateDatapackWithStats)(ir, { optimizeCommands: false, mangle, scoreboardObjective: scoreboardObj });
     }
     return {
         files: [...generated.files, ...generated.advancements],

package/dist/lowering/index.d.ts

@@ -7,6 +7,9 @@
 import type { IRModule } from '../ir/types';
 import type { SourceRange } from '../compile';
 import type { Program } from '../ast/types';
+/** Current scoreboard objective. Set once per compile() call. */
+export declare let LOWERING_OBJ: string;
+export declare function setScoreboardObjective(obj: string): void;
 export interface Warning {
     message: string;
     code: string;