1.0

1. 添加容器锁功能
2. 修复了前缀并未被文档引用的 bug
3. 添加死亡信息功能
4. 调整 .tri 的最大距离
5. 添加违禁品检测鼠标物品能力
6. 添加命令详细文档功能
7. 将整体 API 更新至 1.21.20

manifest.json

@@ -6,7 +6,7 @@
     "header": {
         "name": "自定义命令",
         "description": "基岩之上服务器模组。提供服务器所有的命令功能。",
-        "min_engine_version": [ 1, 21, 1 ],
+        "min_engine_version": [ 1, 21, 20 ],
         "uuid": "03bdd0ea-7bfe-4645-8622-e6b984d79f6e",
         "version": [ 1, 0, 0 ]
     },
@@ -27,11 +27,11 @@
     "dependencies": [
         {
             "module_name": "@minecraft/server",
-            "version": "1.12.0-beta"
+            "version": "1.14.0-beta"
         },
         {
             "module_name": "@minecraft/server-ui",
-            "version": "1.1.0"
+            "version": "1.3.0-beta"
         }
     ]
 }

scripts/chestlock.js

@@ -0,0 +1,295 @@
+//@ts-check
+import { Block, BlockComponentTypes, BlockInventoryComponent, BlockPermutation, Container, Dimension, ItemStack, MolangVariableMap, Player, system, world } from "@minecraft/server";
+import { randomInt } from "./utils/random";
+
+export function chestlockInit(){}
+
+/**@typedef {0 | 1 | 2 | 3 | 4 | 5} NumericDirection*/
+const containerIds = [
+    "chest",
+    "trapped_chest",
+    "barrel",
+    "furnace",
+    "smoker",
+    "blast_furnace",
+    "dispenser",
+    "dropper",
+    "hopper"
+];
+
+/**判断是否为可以锁上的容器方块。
+ * @param {Block} block
+ * @returns {boolean}
+ */
+function isContainer(block){
+    return containerIds.includes(block.typeId.replace("minecraft:", "")) || /minecraft:.+_shulker_box/.test(block.typeId);
+}
+
+/**获取维度魔数。
+ * @param {Dimension} dimension
+ * @returns {"o" | "n" | "e"}
+ */
+function getDimensionML(dimension){
+    return dimension.id === "minecraft:overworld" ? "o" : dimension.id === "minecraft:nether" ? "n" : "e";
+}
+
+/**生成附加属性键名。
+ * @param {Block} block
+ * @param {boolean} isOminous
+ */
+function generateKey(block, isOminous){
+    return `${isOminous === true ? "o" : ""}${block.location.x},${block.location.y},${block.location.z}${getDimensionML(block.dimension)}`;
+}
+
+/**设置坐标密码。
+ * @param {Block} block
+ * @param {string} password
+ * @param {boolean} isOminous
+ */
+function setPassword(block, password, isOminous){
+    //world.sendMessage(`set ${block.location.x} ${block.location.y} ${block.location.z}`);
+    world.setDynamicProperty(generateKey(block, isOminous), password);
+}
+
+/**获取密码。
+ * @param {Block} block
+ * @param {boolean} isOminous
+ * @returns {string | undefined}
+ */
+function getPassword(block, isOminous){
+    return /**@type {string | undefined}*/ (world.getDynamicProperty(generateKey(block, isOminous)));
+}
+
+/**重置坐标的全部密码。
+ * @param {Block} block
+ */
+function resetPassword(block){
+    //world.sendMessage(`reset ${generateKey(block, false)}`);
+    world.setDynamicProperty(generateKey(block, false), undefined);
+    world.setDynamicProperty(generateKey(block, true), undefined);
+}
+
+//@ts-ignore 扩展。。。。。
+world.beforeEvents.playerInteractWithBlock.subscribe(
+    /**@param {{
+     *     block :Block;
+     *     blockFace :Direction;
+     *     cancel :boolean;
+     *     faceLocation :import("@minecraft/server").Vector3;
+     *     itemStack? :ItemStack;
+     *     player :Player;
+     * }} data*/
+    data=>{
+        if(isContainer(data.block)){
+            const
+                /**@type {Block}*/
+                containerBlock = data.block,
+                password = getPassword(containerBlock, false),
+                opassword = getPassword(containerBlock, true),
+                item = data.itemStack,
+                /**@type {import("@minecraft/server").Vector3}*/
+                center = {
+                    x: containerBlock.location.x + 0.5,
+                    y: containerBlock.location.y + 0.5,
+                    z: containerBlock.location.z + 0.5,
+                };
+            if(
+                (password || opassword)
+             && (!item
+                 || (
+                        (item.typeId !== "minecraft:trial_key" || password !== item.nameTag)
+                     && (item.typeId !== "minecraft:ominous_trial_key" || opassword !== item.nameTag)
+                    )
+                )
+            ){
+                data.cancel = true;
+                data.player.sendMessage("§c容器已上锁，请手持名称为其密码的（不祥）试炼钥匙开启！");
+                system.run(()=>{
+                    containerBlock.dimension.playSound("vault.insert_item_fail", center, {
+                        volume: 1.0,
+                        pitch: randomInt(8, 11) / 10
+                    });
+                    const particleCount = randomInt(15, 25);
+                    for(let i = 0; i < particleCount; i++) containerBlock.dimension.spawnParticle("minecraft:basic_smoke_particle", {
+                        x: containerBlock.location.x + randomInt(-10, 110) / 100,
+                        y: containerBlock.location.y + randomInt(10, 60) / 100,
+                        z: containerBlock.location.z + randomInt(-10, 110) / 100,
+                    });
+                });
+            }
+            else if(
+                !(password || opassword)
+             && item
+             && (item.typeId === "minecraft:trial_key" || item.typeId === "minecraft:ominous_trial_key")
+             && item.nameTag
+            ){
+                data.cancel = true;
+                setPassword(containerBlock, item.nameTag, item.typeId === "minecraft:ominous_trial_key");
+                const anotherChestBlock = findLinkedDoubleChest(containerBlock);
+                if(anotherChestBlock) setPassword(anotherChestBlock, item.nameTag, item.typeId === "minecraft:ominous_trial_key");
+                data.player.sendMessage("§e成功给容器上锁。");
+                system.run(()=>{
+                    containerBlock.dimension.playSound("vault.insert_item", center, {
+                        volume: 1.0,
+                        pitch: randomInt(8, 11) / 10
+                    });
+                });
+            }
+        }
+    }
+);
+
+/**返回undefined，要不传入方块不符合条件，要不没有双箱子。
+ * @typedef {"north" | "south" | "west" | "east"} DirectionOfChest
+ * @param {Block} block
+ * @returns {Block | undefined}
+ */
+function findLinkedDoubleChest(block){
+    if(block.typeId === "minecraft:chest" && /**@type {BlockInventoryComponent}*/(block.getComponent(BlockComponentTypes.Inventory)).container?.size === 54){
+        const direction = /**@type {DirectionOfChest}*/ (block.permutation.getState("minecraft:cardinal_direction"));
+        switch(direction){
+            case "north":
+                if(getLargeChestBlocks(block, direction, "west") % 2) return block.west(1);
+                else if(getLargeChestBlocks(block, direction, "east") % 2) return block.east(1);
+                break;
+            case "south":
+                if(getLargeChestBlocks(block, direction, "west") % 2) return block.west(1);
+                else if(getLargeChestBlocks(block, direction, "east") % 2) return block.east(1);
+                break;
+            case "west":
+                if(getLargeChestBlocks(block, direction, "north") % 2) return block.north(1);
+                else if(getLargeChestBlocks(block, direction, "south") % 2) return block.south(1);
+                break;
+            case "east":
+                if(getLargeChestBlocks(block, direction, "north") % 2) return block.north(1);
+                else if(getLargeChestBlocks(block, direction, "south") % 2) return block.south(1);
+                break;
+        }
+        console.error(`Direction for lightning rod get other cases: ${direction}`);
+        world.sendMessage("§e您有一条新的 bug 消息，请及时查收！");
+    }
+    else return undefined;
+}
+
+/**探测该方向同朝向双箱子的个数。
+ * @param {Block} block 初始方块。
+ * @param {DirectionOfChest} faceDirection 方块朝向。
+ * @param {DirectionOfChest} searchDirection 搜索方向。
+ * @returns {number}
+ */
+function getLargeChestBlocks(block, faceDirection, searchDirection){
+    let result = -1,
+        /**@type {Block | undefined}*/
+        newBlock = block;
+    while(newBlock && newBlock.typeId === "minecraft:chest" && /**@type {BlockInventoryComponent}*/(newBlock.getComponent(BlockComponentTypes.Inventory)).container?.size === 54 && newBlock.permutation.getState("minecraft:cardinal_direction") === faceDirection){
+        switch(searchDirection){
+            case "north":
+                newBlock = newBlock.north(1);
+                break;
+            case "south":
+                newBlock = newBlock.south(1);
+                break;
+            case "west":
+                newBlock = newBlock.west(1);
+                break;
+            case "east":
+                newBlock = newBlock.east(1);
+                break;
+        }
+        result++;
+    }
+    return result;
+}
+
+world.beforeEvents.explosion.subscribe(data=>{
+    const blocks = data.getImpactedBlocks();
+    for(let i = 0; i < blocks.length; i++) if(isContainer(blocks[i])) resetPassword(blocks[i]);
+});
+
+world.beforeEvents.playerBreakBlock.subscribe(data=>resetPassword(data.block));
+
+world.afterEvents.playerPlaceBlock.subscribe(data=>{
+    const anotherChestBlock = findLinkedDoubleChest(data.block);
+    if(anotherChestBlock){
+        const password = getPassword(anotherChestBlock, false), opassword = getPassword(anotherChestBlock, true);
+        if(password) setPassword(data.block, password, false);
+        else if(opassword) setPassword(data.block, opassword, true);
+    }
+});
+
+//@ts-ignore
+world.beforeEvents.playerPlaceBlock.subscribe(
+    /**@param {{
+     *     block :Block;
+     *     cancel :boolean;
+     *     dimension :Dimension;
+     *     face :Direction;
+     *     faceLocation :import("@minecraft/server").Vector3;
+     *     permutationBeingPlaced :BlockPermutation;
+     *     player :Player;
+     * }} data*/
+    data=>{
+        if(data.permutationBeingPlaced.type.id === "minecraft:dispenser"){
+            const direction = /**@type {NumericDirection}*/ (data.permutationBeingPlaced.getState("facing_direction"));
+            switch(direction){
+                case 0:
+                    const below = data.block.below(1);
+                    if(below) resetPassword(below);
+                    break;
+                case 1:
+                    const above = data.block.above(1);
+                    if(above) resetPassword(above);
+                    break;
+                case 2:
+                    const north = data.block.north(1);
+                    if(north) resetPassword(north);
+                    break;
+                case 3:
+                    const south = data.block.south(1);
+                    if(south) resetPassword(south);
+                    break;
+                case 4:
+                    const west = data.block.west(1);
+                    if(west) resetPassword(west);
+                    break;
+                case 5:
+                    const east = data.block.east(1);
+                    if(east) resetPassword(east);
+                    break;
+            }
+        }
+        if(data.permutationBeingPlaced.type.id !== "minecraft:water") resetPassword(data.block);
+    }
+);
+
+world.afterEvents.pistonActivate.subscribe(data=>{
+    const
+        isExpanding = data.isExpanding,
+        originBlocks = data.piston.getAttachedBlocks(),
+        faceLocation = /**@type {NumericDirection}*/ (data.piston.block.permutation.getState("facing_direction"));
+    system.runTimeout(()=>{
+        for(let i = 0; i < originBlocks.length; i++){
+            const movedBlock = (()=>{
+                switch(faceLocation){
+                    case 0: return isExpanding ? originBlocks[i].below(1) : originBlocks[i].above(1);
+                    case 1: return isExpanding ? originBlocks[i].above(1) : originBlocks[i].below(1);
+                    case 2: return isExpanding ? originBlocks[i].south(1) : originBlocks[i].north(1);
+                    case 3: return isExpanding ? originBlocks[i].north(1) : originBlocks[i].south(1);
+                    case 4: return isExpanding ? originBlocks[i].east(1) : originBlocks[i].west(1);
+                    case 5: return isExpanding ? originBlocks[i].west(1) : originBlocks[i].east(1);
+                }
+            })();
+            if(movedBlock && isContainer(movedBlock)){
+                const password = getPassword(originBlocks[i], false), opassword = getPassword(originBlocks[i], true);
+                if(password){
+                    resetPassword(originBlocks[i]);
+                    setPassword(movedBlock, password, false);
+                }
+                else if(opassword){
+                    resetPassword(originBlocks[i]);
+                    setPassword(movedBlock, opassword, true);
+                }
+            }
+        }
+    }, 2);
+});