# # KubeJS 筆記
以下資訊皆以KubeJS最新支援版本、Forge（NeoForge優先，LexForge次要）為主
[TOC]
---
## 下載測試版 KubeJS
- [Rhino NeoForge][saps_meven-rhino_neoforge]
- [KubeJS NeoForge][saps_meven-kubejs_neoforge]
## 連結區
|名稱|性質|連結|
|:-:|:-:|:--|
|KubeJS Wiki|官方|https://kubejs.com/wiki/ |
|latvian.dev Discord|官方|https://discord.gg/lat |
|Mango 的 KubeJS 筆記|非官方|https://hackmd.io/@mango-minecraft-notes/KubeJS-Notes |
|Wudji 的 KubeJS 教程（1.19+）|非官方|https://wudji.gitbook.io/xplus-kubejs-tutorial-v2-zh_cn |
|Wudji 的 KubeJS 教程（1.16-1.18）|非官方|https://wudji.gitbook.io/xplus-kubejs-tutorial-v1-zh_cn |
---
## 小技巧
### 腳本預處理參數 [KubeJS 6+]
可在腳本開頭使用預處理參數，如下
|名稱|用途|參數類別|說明|預設值|
|:-:|---|---|---|:-:|
|`priority`|載入優先度|整數(Number)|數字越大越先載入|`0`|
|`ignored`|忽略載入|布林(Boolean)|如果是true則跳過載入|`false`|
|`packmode`|模組包模式|字串(String)|若模組包模式不等於輸入值內則跳過載入|`default`|
|`requires`|命名空間需求|字串(String)|若未載入該命名空間則跳過載入|` ` (無)|
||||||
#### 範例
```javascript=
// priority: 100
// ignored: false
// packmode: dev
// requires: forge
// requires: create
```
### 自製 KubeJS 用 VSCode Code Snippet
```json=
{
"event": {
"scope": "javascript,typescript",
"prefix": "$event",
"body": ["(event) => {", " $0", "}"]
},
"priority": {
"scope": "javascript,typescript",
"prefix": "$priority",
"body": ["// priority: $1", "$0"]
},
"ignored": {
"scope": "javascript,typescript",
"prefix": "$ignored",
"body": ["// ignored: ${1|true,false|}", "$0"]
},
"packmode": {
"scope": "javascript,typescript",
"prefix": "$packmode",
"body": ["// packmode: $1", "$0"]
},
"requires": {
"scope": "javascript,typescript",
"prefix": "$requires",
"body": ["// requires: $1", "$0"]
},
"todo": {
"scope": "javascript,typescript",
"prefix": "$todo",
"body": ["// TODO", "$0"]
},
"license": {
"scope": "javascript,typescript",
"prefix": "$license",
"body": ["/**", " * @author MangoJellyPudding", " */", "", ""]
},
"disable ts-except-error": {
"scope": "typescript",
"prefix": "$disable-ts-except-error",
"body": ["// @ts-expect-error", "$0"]
}
}
```
### 將腳本自動同步到 Github
以下步驟皆以Prism Launcher為基礎
1. 備份 `.minecraft`；
2. 清空原有的 `.minecraft`；
3. 在 `.minecraft` 中輸入 `git clone "儲存庫網址" .`；
4. 將備份的 `.minecraft` 內的檔案放回 `.minecraft`，視情況選擇覆蓋舊有的或保留舊有的；
5. 新增以下檔案：
- `.minecraft/.gitignore`
```
*
!.gitignore
!kubejs/
```
- `.minecraft/kubejs/.gitignore`
```
!*
probe/
```
### 讀取任意模組的Json檔案
[pietro-lopes/read_json_from_mod.js](https://gist.github.com/pietro-lopes/1471e43c6acef411fd98f10908185fae)
### *Beans*
Kubejs 有一個名為 *beans* 的功能，可以讓腳本更易讀。
任何 `getXy()` 都可以用 `xy` 來獲取，任何 `setXy(value)` 都可以用 `xy = value` 來設置，任何 `isXy()` 都可以用 `xy` 來檢查。
這樣我們就可以縮短代碼！例如，要獲取所有在線玩家的列表，可以使用 `event.getServer().getPlayers()`。有了 *beans* ，這可以縮短為 `event.server.players`！
請注意，只有當方法沒有參數時，`get` 和 `is` 時 *beans* 才會起作用。這意味著像 `getHeldItem(InteractionHand hand)` 這樣的方法不能簡寫為 `heldItem`。
對於 `set` 方法，需要有一個參數。
### 實用模組（非KubeJS Addon為主）
#### ProbeJS
|[![badge-curseforge]][probejs-curseforge]|[![badge-modrinth]][probejs-modrinth]|[![badge-mcmod]][probejs-mcmod]|[![badge-wiki]][probejs-wiki]|
|---|---|---|---|
> ProbeJS 的功能是收集你的模組包中的方塊/物品等資訊，供 VSCode 編輯器使用。
- tags: `vscode`, `code snippets`
#### Lychee
|[![badge-curseforge]][lychee-curseforge]|[![badge-modrinth]][lychee-modrinth]|[![badge-mcmod]][lychee-mcmod]|[![badge-wiki]][lychee-wiki]|
|---|---|---|---|
> Lychee 是一個允許你使用 JSON 合成表和數據包定義自訂交互的模組。
- tags: `recipe`, `world intercation`
#### Loquat🧩
<!-- |[![badge-curseforge]][loquat-curseforge]|[![badge-modrinth]][loquat-modrinth]|[![badge-mcmod]][loquat-mcmod]|[![badge-wiki]][loquat-wiki]|
|---|---|---|---| -->
|[![badge-curseforge]][loquat-curseforge]|[![badge-modrinth]][loquat-modrinth]|[![badge-wiki]][loquat-wiki]|
|---|---|---|
> Loquat🧩 為 Minecraft 地圖製作者提供的區域管理和結構生成模組。
- tags: `worldgen`, `structure`
#### Custom Fluid Mixin
|[![badge-curseforge]][custom_fluid_mixin-curseforge]|[![badge-modrinth]][custom_fluid_mixin-modrinth]|[![badge-mcmod]][custom_fluid_mixin-mcmod]|[![badge-wiki]][custom_fluid_mixin-wiki]|
|---|---|---|---|
> 借助資料包，本模組允許你在流體（例如岩漿、水）流動時產生一個方塊（例如岩漿流動遇水時可以不再是產生黑曜石，能夠自訂任何方塊）、產生一陣爆炸或執行一個資料包函數。
- tags: `recipe`, `world intercation`
#### Origins (Forge)
|[![badge-curseforge]][origins_forge-curseforge]|[![badge-modrinth]][origins_forge-modrinth]|[![badge-mcmod]][origins_forge-mcmod]|[![badge-wiki]][origins_forge-wiki]|
|---|---|---|---|
> 本模組可以讓你在遊戲開始之前選擇你的種族，它們特有的能力可以幫助你，也可能會妨礙你的正常生存！
可以透過禁用全部種族來讓此模組轉變成僅修改各種玩家屬性的模組
- tags: `player attributes`
#### Custom Machinery
|[![badge-curseforge]][custom_machinery-curseforge]|[![badge-modrinth]][custom_machinery-modrinth]|[![badge-mcmod]][custom_machinery-mcmod]|[![badge-wiki]][custom_machinery-wiki]|
|---|---|---|---|
> 這個模組讓你使用資源包創建自己的機器並添加進遊戲中。
- tags: `multiblock`, `custom machine`
#### Multiblocked
|[![badge-curseforge]][multiblocked-curseforge]|[![badge-mcmod]][multiblocked-mcmod]|[![badge-wiki]][multiblocked-wiki]|
|---|---|---|
<!-- |[![badge-curseforge]][multiblocked-curseforge]|[![badge-modrinth]][multiblocked-modrinth]|[![badge-mcmod]][multiblocked-mcmod]|[![badge-wiki]][multiblocked-wiki]|
|---|---|---|---| -->
> Multiblocked是一個極其靈活但具有原版風格的自訂多方塊模組。
- tags: `multiblock`, `custom machine`
#### Lopy's More Materials
|[![badge-curseforge]][lopys_more_materials-curseforge]|[![badge-modrinth]][lopys_more_materials-modrinth]|[![badge-mcmod]][lopys_more_materials-mcmod]|
|---|---|---|
> 這是一個簡單的模組，它為模組/模組包作者添加了大量可供魔改配方的材料。
>
> <img src="https://media.forgecdn.net/attachments/614/397/mmt_items.png" height="500">
## 腳本範例
### KubeJS Create 所提供的 `CreateEvents`
#### 蒸氣鍋爐熱量源 - `boilerHeatHandler`
```javascript=
CreateEvents.boilerHeatHandler((event) => {
//? 熱量等級說明：
//? -1：此方塊不提供任何形式的熱量。
//? 0 ：此方塊提供被動熱量。（例如未加燃料的烈焰燃燒器）
//? 1 ：此方塊提供1單位的熱量（在狀態欄中顯示1個綠色條，例如加燃料的烈焰燃燒器）
//? 2 ：此方塊提供2單位的熱量（例如烈焰蛋糕燃燒器）
//? X ：此方塊提供X單位的熱量，狀態欄中顯示X個綠色條
//?
//? 注意，回調函數僅在鍋爐有更新信號時調用。
//? 例如相鄰方塊的狀態變化、破壞或放置等。
//? 添加單個方塊的加熱器。
//? 回調函數的參數類型為 BlockContainerJS。
event.add("minecraft:diamond_block", (block) => {
return 2;
});
//? 添加方塊篩選器的加熱器。
event.addAdvanced("#minecraft:logs", (block) => {
if (block.id === "minecraft:oak_log") {
return 1;
} else {
return 2;
}
});
});
```
#### 管道流體效果 - `pipeFluidEffect`
```javascript=
CreateEvents.pipeFluidEffect((event) => {
//? 添加液體處理器，支援 FluidIngredient。
event.add(
Fluid.water(), // 流體
(pipe, fluid) => {
const { world } = pipe;
if (world.server.tickCount % 5 != 0) return;
world.getEntitiesWithin(pipe.AOE).forEach((entity) => {
if (entity.living) {
entity.heal(5);
}
});
}
);
});
```
#### 注液器注液方塊 - `spoutHandler`
```javascript=
CreateEvents.spoutHandler((event) => {
//? 創建注液器處理器，需要提供 ID，因為這裡沒有辦法生成一個一致的 UUID。
//?
//? 注液器每個 tick 都會以 simulate = true 的方式調用處理器，如果返回值 > 0，則注液器將開始注液動畫，
//? 動畫結束時，處理器將再次以 simulate = false 的方式調用。
//?
//? 返回的整數表示此操作應該消耗多少單位液體。
//? 單位視模組載入器而不同，Forge = 1MB、Fabric = 1 unit
//? 1 B（Bucket，桶） = 1000 MB（MiliBucket，千分之一桶） = 81000 unit（單位流體）
event.add(
"kubejs:obsidian", // ID
"minecraft:lava", // 目標方塊
(block, fluid, simulate) => {
if (fluid.id === Fluid.water().id && fluid.amount >= 100) {
if (!simulate) {
block.set("minecraft:obsidian");
}
return 100;
}
return 0;
});
});
```
### 替換多個物品配方
```javascript=
ServerEvents.recipes((event) => {
event.replaceInput(
{
output: [
"minecraft:diamond_axe",
"minecraft:diamond_hoe",
"minecraft:diamond_pickaxe",
"minecraft:diamond_shovel",
"minecraft:diamond_sword",
],
},
"minecraft:diamond",
"minecraft:emerald"
);
});
```
### 玩家死亡後掉落玩家頭顱
```javascript=
EntityEvents.death("player", (event) => {
const { player } = event;
player.block.popItem(Item.playerHead(player.username));
});
```
### 合成時消耗物品耐久
```javascript=
ServerEvents.recipes((event) => {
const { kubejs } = event.recipes;
kubejs
.shapeless("stripped_oak_log", ["oak_log", "#minecraft:axes"])
.damageIngredient("#minecraft:axes");
});
```
:::info
僅限 `kubejs:shaped` 和 `kubejs:shapeless` 配方可使用 `.damageIngredient`
:::
### 獲取精確的世界種子
```javascript=
const seed = NBT.l(server.worldData.worldGenOptions().seed());
```
:::warning
只能儲存成 String 或 NBT，若存成 Number 則會因為 Java Double 浮點數精度誤差導致不精確
:::
#### 在配方中使用
```javascript=
ServerEvents.loaded((event) => {
const { server } = event;
const seed = server.worldData.worldGenOptions().seed();
server.persistentData.putLong("seed", seed);
server.scheduleInTicks(10, () => server.runCommandSilent("reload"));
});
ServerEvents.recipes((event) => {
const { server } = Utils;
if (!server) return;
const seed = server.persistentData.getLong("seed");
// do_something(seed);
});
```
### 根據材料修改合成產物
```javascript=
ServerEvents.recipes((event) => {
const { kubejs } = event.recipes;
kubejs
.shapeless(Item.of("wooden_axe").withName([Text.red("斧頭只會被清除附魔，不會被替換成木斧")]), [
Ingredient.of("#minecraft:axes").itemIds.map((id) =>
Item.of(id).enchant("flame", 2).weakNBT()
),
"sponge",
])
.keepIngredient("sponge")
.modifyResult((grid, result) => {
const item = grid.find(Ingredient.of("#minecraft:axes"));
item.nbt.remove("Enchantments");
return item;
});
});
```
:::info
僅限 `kubejs:shaped` 和 `kubejs:shapeless` 配方可使用 `.modifyResult`
:::
### 玩家在芒草蹲下後隱身
```javascript=
PlayerEvents.tick((event) => {
const { player } = event;
if (player.shiftKeyDown && player.block.id === "minecraft:tall_grass") {
if (!player.hasEffect("invisibility")) {
player.potionEffects.add("invisibility", -1, 0, false, false);
}
} else {
player.removeEffect("invisibility");
}
});
```
### 玩家範圍聊天
```javascript=
const $maxDistance = 10;
/**
* @param {Internal.Player_} sender
* @param {string} message
* @param {Internal.MinecraftServer_} server
* @returns {Internal.Component}
*/
const $textFactory = (sender, message, server) => [Text.green(`[${sender.username}] `), message];
PlayerEvents.chat((event) => {
const { player: sender, message, server } = event;
server.players.forEach((player) => {
if (sender.distanceToEntity(player) < $maxDistance) {
player.tell($textFactory(sender, message, server));
}
});
event.cancel();
});
```
### 在草地上跳躍有機率將草地踩成泥土
```javascript=
const inputBlock = "minecraft:grass_block";
const outputBlock = "minecraft:dirt";
PlayerEvents.tick((event) => {
const { player } = event;
if (player.fallDistance > 1 && player.block.down.id === inputBlock) {
player.tell("You fell on grass block!");
if (Math.random() < 0.25) {
player.block.down.set(outputBlock);
player.tell(" The grass turned into dirt!");
}
}
});
```
### 玩家每開啟10次村莊中的戰利品箱後觸發
```javascript=
const dataKey = "villageChestsOpened";
const maxOpenTimes = 10;
BlockEvents.rightClicked("chest", (event) => {
const { player, block } = event;
if (block.entityData.getString("LootTable").includes("chests/village/")) {
player.persistentData.putLong(dataKey, player.persistentData.getLong(dataKey) + 1);
player.tell("You've opened a village chest!");
if (player.persistentData.getLong(dataKey) >= maxOpenTimes) {
player.tell(" You've opened 10 village chests!");
player.persistentData.putLong(dataKey, 0);
}
}
});
```
### 隨機羊毛剪刀
#### Startup
```javascript=
StartupEvents.registry("item", (event) => {
event.create("random_shear", "shears").texture(":item/shears").maxDamage(238);
});
```
#### Server
```javascript=
ItemEvents.entityInteracted("kubejs:random_shear", (event) => {
const { entity, target, item, hand, server } = event;
const colors = Object.keys(Color.DYE);
function shear() {
server.runCommandSilent(
`playsound entity.sheep.shear master @a ${target.x} ${target.y} ${target.z} 1 1`
);
target.setSheared(true);
let i = 1 + Utils.random.nextInt(3),
j = 0,
color;
for (j; j < i; ++j) {
color = colors[Utils.getRandom().nextInt(16)];
target.block.popItem(`${color}_wool`);
}
}
if (target.type === "minecraft:sheep" && target.readyForShearing()) {
shear();
item.hurtAndBreak(1, entity, (entityx) => entityx.broadcastBreakEvent(hand));
event.cancel();
}
});
```
### 隨機混凝土鎬
#### Startup
```javascript=
StartupEvents.registry("item", (event) => {
event.create("random_concrete_pickaxe", "pickaxe").texture(":item/iron_pickaxe").maxDamage(250);
});
```
#### Server
```javascript=
BlockEvents.broken((event) => {
const { entity, block } = event;
if (entity.mainHandItem.id === "kubejs:random_concrete_pickaxe" && block.hasTag("forge:stone")) {
let color = Object.keys(Color.DYE)[Utils.random.nextInt(16)];
block.popItem(`${color}_concrete`);
block.set("air");
event.cancel();
}
});
```
### 物品實體名稱高亮顯示
```javascript=
ServerEvents.tick((event) => {
const { server } = event;
if (server.tickCount % 2) return;
server.entities.filterSelector("@e[type=item]").forEach(
/** @param {Internal.ItemEntity_} itemEntity */
(itemEntity) => {
/** @type {{Item: { Count: Internal.ByteTag_, id: string }, Age: Internal.ShortTag_}} nbt */
const { Item: item, Age } = itemEntity.nbt;
const { descriptionId, rarity } = Item.of(item.id);
itemEntity.customName = [
Text.gold(`${item.Count}x`),
" ",
Text.translate(descriptionId).color(rarity.color),
" ",
Text.gray(`(${Age == -32768 ? "∞" : ((6000 - Age) / 20).toFixed(1)}s left)`),
];
itemEntity.customNameVisible = true;
}
);
});
```
### 獲取當前月相
```javascript=
const moonPhaseList = ["滿", "虧凸", "下弦", "殘", "新", "峨嵋", "滿", "滿"];
LevelEvents.tick("overworld", (event) => {
const { moonPhase, dayTime, server } = event;
if (dayTime % 24000 === 1) {
server.tell(`今天的月像是${moonPhaseList[moonPhase]}月`);
}
});
```
### 禁止玩家使用特定指令
*==You Shall Not Pass!==*
```javascript=
/**
* @param {Internal.CommandEventJS_} event
*/
function youShallNotUsePainter(event) {
const { input, parseResults } = event;
if (input.split(" ")[1] === "painter") {
parseResults.context.source.player.tell("You Shall Not Use Painter!");
event.cancel();
}
}
ServerEvents.command("kubejs", youShallNotUsePainter);
ServerEvents.command("kjs", youShallNotUsePainter);
```
### 修改物品的Builder
```javascript=
ItemEvents.modification((event) => {
const ItemBuilder = Java.loadClass(
"dev.latvian.mods.kubejs.item.custom.BasicItemJS$Builder"
);
event.modify("...", (item) => {
const builder = new ItemBuilder("...").glow(true);
item.setItemBuilder(builder);
});
});
```
### 套裝效果 + tooltip提示
使用nbt達成tooltip提示
#### server_script
```javascript=
global.armorSets = {
netherite: "Netherite Armor Set",
};
PlayerEvents.inventoryChanged((event) => {
const { item, player, slot } = event;
if (item.hasTag("forge:armors") && !item?.nbt?.armor_set) {
item.setNbt({ armor_set: "" });
}
for (let key of Object.keys(global.armorSets)) {
let setName = player.armorSlots.every((armor) => Utils.id(armor.id).path.startsWith(key))
? key
: "";
player.armorSlots.forEach((eachArmor) => {
if (!eachArmor.empty) eachArmor.setNbt({ armor_set: setName });
});
player.inventory.getStackInSlot(slot).setNbt({ armor_set: setName });
player.persistentData.putString("armor_set", setName);
}
});
```
#### client_script
```javascript=
ItemEvents.tooltip((event) => {
event.addAdvancedToAll((item, isAdvanced, tooltip) => {
if (item.hasTag("forge:armors") && item?.nbt?.armor_set !== undefined) {
/** @type {{ armor_set: string }} */
const { armor_set } = item.nbt;
if (global.armorSets[armor_set] !== undefined) {
tooltip.add(1, ["Active Armor Set: ", Text.green(global.armorSets[armor_set])]);
} else {
tooltip.add(1, ["Active Armor Set: ", Text.red("No Active")]);
}
}
});
});
```
### 自訂訊息顯示
```js=
PlayerEvents.chat((event) => {
let { player, message, server } = event;
server.tell([Text.yellow(player.displayName), " ", Text.gray("»"), " ", Text.white(message)]);
event.cancel();
});
```
### 附魔描述
部分代碼來源自：KL_jiana
```js=
ClientEvents.lang("zh_tw", (event) => {
event.addAll("enchdesc", {
"tooltip.enchdesc.hold_shift": "§6按住 §eShift §6查看附魔描述§r",
"tooltip.enchdesc.embellish": " ◊ %s: %s",
_comment: "Vanilla Enchantment Descriptions",
"enchantment.minecraft.protection.desc": "減少大部分傷害。",
"enchantment.minecraft.fire_protection.desc": "減少火焰傷害，並減少著火後的燃燒時間。",
"enchantment.minecraft.feather_falling.desc": "減少摔落和使用終界珍珠傳送時的傷害。",
"enchantment.minecraft.blast_protection.desc": "減少爆炸傷害和擊退效果。",
"enchantment.minecraft.projectile_protection.desc": "減少投射物（如：箭矢、火焰彈）傷害。",
"enchantment.minecraft.respiration.desc": "延長玩家於水中的活動時間，並強化於水中的視力。",
"enchantment.minecraft.aqua_affinity.desc": "增加於水中的挖掘速度。",
"enchantment.minecraft.thorns.desc": "對攻擊你的敵人造成傷害。",
"enchantment.minecraft.sharpness.desc": "增加物品的傷害值。",
"enchantment.minecraft.smite.desc": "增加攻擊不死生物（如：殭屍、骷髏）的傷害。",
"enchantment.minecraft.bane_of_arthropods.desc": "增加攻擊節肢生物（如：蜘蛛、蠹魚）的傷害。",
"enchantment.minecraft.knockback.desc": "增加武器的擊退強度。",
"enchantment.minecraft.fire_aspect.desc": "對攻擊目標造成額外的火焰傷害。",
"enchantment.minecraft.looting.desc": "擊殺生物時將獲得更多戰利品。",
"enchantment.minecraft.efficiency.desc": "增加工具的挖掘速度。",
"enchantment.minecraft.silk_touch.desc": "能取得易損方塊（如：玻璃）。",
"enchantment.minecraft.unbreaking.desc": "使工具的損壞速度降低。",
"enchantment.minecraft.fortune.desc": "額外增加某些方塊（如：煤礦、鑽石礦）的掉落物。",
"enchantment.minecraft.power.desc": "增加弓的射擊傷害。",
"enchantment.minecraft.punch.desc": "增加弓的擊退強度。",
"enchantment.minecraft.flame.desc": "射出的箭矢將造成額外的火焰傷害。",
"enchantment.minecraft.infinity.desc": "使弓能無限射出普通箭矢，必須擁有至少一支箭。",
"enchantment.minecraft.luck_of_the_sea.desc": "增加釣魚獲得優良戰利品的機率。",
"enchantment.minecraft.lure.desc": "減少等待魚上鉤的時間。",
"enchantment.minecraft.depth_strider.desc": "增加於水中的移動速度。",
"enchantment.minecraft.frost_walker.desc": "使玩家下方的水結冰。",
"enchantment.minecraft.mending.desc": "以經驗回復盔甲和工具的耐久度。",
"enchantment.minecraft.binding_curse.desc": "防止卸下盔甲欄中的詛咒物品。",
"enchantment.minecraft.vanishing_curse.desc": "銷毀死亡時物品欄中的詛咒物品。",
"enchantment.minecraft.sweeping.desc": "增加橫掃攻擊的傷害。",
"enchantment.minecraft.loyalty.desc": "使三叉戟於射出後自動返回。",
"enchantment.minecraft.impaling.desc": "增加攻擊玩家和水生生物的傷害。",
"enchantment.minecraft.riptide.desc": "使玩家能使用三叉戟突進，僅於雨中或水中有效。",
"enchantment.minecraft.channeling.desc": "使三叉戟能於暴風雨中召喚閃電電流。",
"enchantment.minecraft.multishot.desc": "往相近方向射出額外箭矢。",
"enchantment.minecraft.quick_charge.desc": "增加弩的裝填速度。",
"enchantment.minecraft.piercing.desc": "使投射物能貫穿生物。",
"enchantment.minecraft.soul_speed.desc": "增加於靈魂方塊上的移動速度。",
"enchantment.minecraft.swift_sneak.desc": "增加於潛行時的移動速度。",
});
});
ItemEvents.tooltip((event) => {
const EMBELLISH_TEXT = (arg0, arg1) => Text.translate("tooltip.enchdesc.embellish", arg0, arg1);
const HOLD_SHIFT_TEXT = Text.translate("tooltip.enchdesc.hold_shift");
const ENCHANTED_BOOK = Ingredient.of("minecraft:enchanted_book");
event.addAdvanced(Ingredient.all, (item, advanced, text) => {
if (!ENCHANTED_BOOK.test(item) && !item.enchanted) return;
const { enchantments } = item;
if (event.shift) {
enchantments.forEach((enchantment) => {
let descriptionId = `enchantment.${enchantment.replace(":", ".")}`;
text.add(EMBELLISH_TEXT(Text.translate(descriptionId), Text.translate(`${descriptionId}.desc`).darkGray()));
});
} else {
text.add(HOLD_SHIFT_TEXT);
}
});
});
```
## 筆記
### DamageSource 中 `immediate` 與 `actual` 的差異
`immediate` 回傳直接傷害者
`actual` 回傳傷害所有者
舉例來說，玩家拿弓箭射實體：
- `immediate` 回傳 `Arrow` (弓箭)
- `actual` 回傳 `Player` (玩家)
### `PlayerEvents.chat` 與 `PlayerEvents.decorateChat` 的差異
- `PlayerEvents.chat`：可以被取消，主要用途為取消事件。
- `PlayerEvents.decorateChat`：不能被取消，主要用途為修改訊息。
### `ItemStack.weakNBT()` 與 `ItemStack.strongNBT()` 的差異
以 `Item.of("diamond_sword", "{damage:50}")` 舉例
- `.weakNBT()`
若物品的nbt包含 `{damage:50}` 則可以使用
舉例：
- :o: `{damage:50}`
- :o: `{damage:50, display:"Sword"}`
- :x: `{display:"Sword"}`
- `.strongNBT()`
若物品的nbt ==**僅**== 包含 `"{damage:50}"` 則可以使用
舉例：
- :o: `{damage:50}`
- :x: `{damage:50, display:"Sword"}`
- :x: `{display:"Sword"}`
---
<!-- badge links -->
[badge-curseforge]: https://img.shields.io/badge/CurseForge-313338?style=for-the-badge&logo=CurseForge
[badge-modrinth]: https://img.shields.io/badge/Modrinth-313338?style=for-the-badge&logo=Modrinth
[badge-mcmod]: https://img.shields.io/badge/MC%E7%99%BE%E7%A7%91-313338?style=for-the-badge&logo=data%3Aimage%2Fpng%3Bbase64%2CiVBORw0KGgoAAAANSUhEUgAAACAAAAAgCAYAAABzenr0AAAAIGNIUk0AAHomAACAhAAA%2BgAAAIDoAAB1MAAA6mAAADqYAAAXcJy6UTwAAAAGYktHRAD%2FAP8A%2F6C9p5MAAAUjSURBVFjDvZfbbxRVGMB%2F3zmzO6U3KAVKSwQBK8ViQsS7aI0YMIiCYjUmGkB88kkTH5RXk8Y%2FwRh9MNGkhoiEBzVqTBoVEEmEGC4WWmvvpS29bPcyt3N86O52tyzKA%2B2XTHZmznfm991nViiQto7WpcAh4BXgLkBx%2B%2BQf4GvgkyMtR4dyN6UA%2FgTwEbD5NkJLSZ9g3n6%2F5atj5Dxs62jdCpxYBDiK8I4I98u3vv9iF4C0dbRWAqeB5oWHB4RU0JN5jalwyzUh3OoALywevJzuzAES4Sa0JFcBbzjAvgWHS0Bgqvg7c5BEtBEt6dzSHgdoWli4T2Cq6c4cYibagJZM4fI6ByhfWM9r6MocJBndOR8O4DqAzV1ZbNGViFDQqRTr2eyaBRFknp7gkYlq6cocJm3WoElj7ayOzKlap3iTKlwkshFK5AY81qJEFxuUlSDyUBIRyRp6vAN4toGYeHlHYloIDRg7u8cBMNYQ12Xsb36Xitiy%2FMPODnzL2cFviOslc0aZkGc3vcWaqsY8tnfqIt9d%2BRhrDY2197OtYSdL4o2E1KDwi%2BCXrqf49MIIufg5c%2BFWrK5cT3lsaR62bc0uzg3%2FiMUiCKEJWFWxlq31O5CCKZ0MJvGiNNsadrFv8zvz0lGWP%2Fsn4XHs6jhBZHGUzEUgJ6EJioJdV3En9VUb6Z%2FuJKbiRMZn04qHi%2BC5fa522L52fx5%2BYTzFhBfmU5gMItr%2FGmPCC3D13P4iA3Iy7Y1TEV%2BKFod7Vj5G7%2BRFUDHieglNKx8CwItSYC2uUwHWx3EaqXTrATg9nODD3%2FuLC87OpqAQDjd52%2FVM%2FslQoguA5lXbqXRr8MM0DdWN1FWuB%2BDS6CmmvXEAUqaeAf91ROIA9M94GANLHEWZzh6OQsuNHVXSAC9M0jl2BoAqt5Z1S5vxojT31rUgCNYaLl77Jd8JGVOHZ5cDBgAtQglWSSlpgJYYl8ZOYWwEQNPKR6h0l3N37QMADM%2F0MJS4TEzHZsOMQYhujXhLBiiHkZkeBhNXAFi3rJn76ndS5dYCcHX8Z677dYS2uuRDreWWpaQBgiKMfM4P%2FQRAtbuCpza8DoAxCU4OTdLrHyay8ZJQVyvSkSEdlj5MgXLJLgBwdJyu63%2FghSlcp5y4nu3ni9cz%2FDbeQmW8Mht2hRIhEUQkA0OZVjzWUMVQcgWTXogqUQuXJ9JMZVt03iiW%2FK8WzURmhO6Jc2xe%2BWhe5%2BdBg2%2FKUIT5caMFpv2IXweneX7Dcpa5Dm9uqbtp2D84089YOoGr5f8%2FOs8P%2FwSEAMwEEedGE7jK5izOS1wJ7Z2j%2FNA7STL474IsTIG0dbR2g10vollVsRYtDqlgmon0MCJCTHx02auMBY%2FjRwF9CQ8ElAhrq%2BI4IqRCw2DSx1pLYCyry%2BPUlDncrBMHkj7pwCDCuJNzxVrDwHQnFotCo5WDlgzXggfpnroXwwxKLLFsUq21XJnIzOqLEFOCiOBqYTQdMJIKit6ShRJTKl8bTmEgHZWraosWj9FgO33efhxtswVX7FNcl%2F5ecPKV97%2FTSBxgpvienfXcf5I%2B%2F0WEEMlOuAWQtAIuFMM9Rvwd9Pn7FhoO8LcCjuXgSjyG%2Fafp9%2Fdmx%2BuCwgGOK%2BAE2N%2BVBAz7Oxnwn1sMzwF6gc%2FUkZajGUX02pD%2FzPCgt2ex4Eng1fbdTWMK4L2Wrzsnwy27EXtmEeCXgL3tu5tOwrw%2BefmbLlcRvAK8xOwf1arbBE0BV4HjwOftu5umcwv%2FAs4dLGlGxRDmAAAAJXRFWHRkYXRlOmNyZWF0ZQAyMDIzLTEyLTI5VDEwOjM2OjU1KzAwOjAwPlu%2B7wAAACV0RVh0ZGF0ZTptb2RpZnkAMjAyMy0xMi0yOVQxMDozNjo1NSswMDowME8GBlMAAAAodEVYdGRhdGU6dGltZXN0YW1wADIwMjMtMTItMjlUMTA6MzY6NTUrMDA6MDAYEyeMAAAAAElFTkSuQmCC
[badge-wiki]: https://img.shields.io/badge/Wiki-313338?style=for-the-badge&logo=wikipedia
<!-- 實用模組 -->
[probejs-curseforge]: https://curseforge.com/minecraft/mc-mods/probejs
[probejs-modrinth]: https://modrinth.com/mod/probejs
[probejs-mcmod]: https://mcmod.cn/class/6486
[probejs-wiki]: https://github.com/Prunoideae/ProbeJS/wiki/
[lychee-curseforge]: https://curseforge.com/minecraft/mc-mods/lychee
[lychee-modrinth]: https://modrinth.com/mod/lychee
[lychee-mcmod]: https://mcmod.cn/class/5559
[lychee-wiki]: https://lycheetweaker.readthedocs.io/en/latest/
[loquat-curseforge]: https://curseforge.com/minecraft/mc-mods/loquat
[loquat-modrinth]: https://modrinth.com/mod/loquat
<!-- [loquat-mcmod]: https://mcmod.cn/class/5559 -->
[loquat-wiki]: https://loquat.readthedocs.io/en/latest/
[custom_fluid_mixin-curseforge]: https://curseforge.com/minecraft/mc-mods/custom-fluid-mixin
[custom_fluid_mixin-modrinth]: https://modrinth.com/mod/custom-fluid-mixin
[custom_fluid_mixin-mcmod]: https://mcmod.cn/class/5942
[custom_fluid_mixin-wiki]: https://github.com/Insane96/CustomFluidMixin/wiki
[origins_forge-curseforge]: https://curseforge.com/minecraft/mc-mods/origins-forge
[origins_forge-modrinth]: https://modrinth.com/mod/origins-forge
[origins_forge-mcmod]: https://mcmod.cn/class/4032
[origins_forge-wiki]: https://origins.readthedocs.io/en/latest/
[custom_machinery-curseforge]: https://curseforge.com/minecraft/mc-mods/custom-machinery
[custom_machinery-modrinth]: https://modrinth.com/mod/custom-machinery
[custom_machinery-mcmod]: https://mcmod.cn/class/3903
[custom_machinery-wiki]: https://frinn.gitbook.io/custom-machinery-1.19/
[multiblocked-curseforge]: https://curseforge.com/minecraft/mc-mods/multiblocked
<!-- [multiblocked-modrinth]: https://modrinth.com/mod/multiblocked -->
[multiblocked-mcmod]: https://mcmod.cn/class/6191
[multiblocked-wiki]: https://github.com/Low-Drag-MC/Multiblocked/wiki
[lopys_more_materials-curseforge]: https://curseforge.com/minecraft/mc-mods/morematerials
[lopys_more_materials-modrinth]: https://modrinth.com/mod/morematerials
[lopys_more_materials-mcmod]: https://mcmod.cn/class/11835
<!-- [lopys_more_materials-wiki]: https://frinn.gitbook.io/custom-machinery-1.19/ -->
[saps_meven-rhino_neoforge]: https://maven.saps.dev/#/releases/dev/latvian/mods/rhino-neoforge
[saps_meven-kubejs_neoforge]: https://maven.saps.dev/#/releases/dev/latvian/mods/kubejs-neoforge
{%hackmd @lumynou5/dark-theme %}
<!-- {%hackmd @themes/dracula %} -->
Sign in with Wallet
Connect another wallet