# DabaoSword(大宝刀) This is a mod related to the game "Legends of Three Kingdoms", which adds some cards from "Legends of Three Kingdoms" to Minecraft, such as "Too Happy to Think of Home" and "Iron Shackles" (more gameplay may be added in the future). It not only enriches the gameplay of survival mode but also can be used for PVP. Thriving!\ \ 意见反馈、萌新答疑QQ群：973712806

English

## Main Contents ### Role Mode (v0.6) A 3-team asymmetric PvP mode inspired by the "Legends of Three Kingdoms" role mode.\ In the game, players can use the command `/dabaosword` or **press Left Ctrl + M simultaneously (if the hotkey is occupied, try pressing it in the chat screen)** to open a quick menu composed of text components. Click on [New Game] to view the rules and select a mode.\ When attempting to create a match, the system will pull all players not in another match within 20 blocks (range can be modified in the config file) into the same match, centering around the player. A minimum of two players is required to start a match.\ Once a match is successfully created, a 10-second (configurable) countdown begins. During the preparation phase, any participant can click [Decline to Join] in the chat screen to opt out, preventing the match from starting. **Below are the detailed rules for Role Mode battles (viewable in-game):** 1. **Team Assignment:** At the start of the game, each player is randomly assigned a hidden identity. With three or more players, half (rounded down) will be Rebels, one will be a Turn-coat, and the rest will be Ministers, forming three teams. 2. **Team Lives:** Players can respawn until their team's total lives run out. Eliminated players reveal their identitis and spectate the game. The Rebel team has an average of 3 lives per player. The total lives of the Minister team and the Turn-coat match the Rebels' total lives (e.g., in a 5-player game, 2 Rebels share 6 lives, Ministers have 6 lives, and the Turn-coat has 6 lives; in a 6-player game, 3 Rebels share 9 lives, 2 Ministers share 9 lives, and the Turn-coat has 9 lives). 3. **Scoring:** Ministers gain 1 point for killing a Rebel. Rebels gain 1 point for killing a Minister. The Turn-coat gains 1 point for killing either a Minister or a Rebel. Killing a Turn-coat or a teammate does not award points. 4. **Victory Conditions:** When all members of either the Minister or Rebel team are eliminated, if only one team remains, they win. If both the Turn-coat and another team remain, the team with the higher score wins. If the score is tied, the game continues until the Turn-coat gains score (Turn-coat wins) or dies (remaining team wins). 5. **Timeout Rule:** If no one scores for an extended period (configurable), the game ends. If one team has the highest score, they win; otherwise, no one wins. ### Card Drawing Mechanism - Killing hostile mobs has a small chance (0.1) to draw a card. Killing a player draws 1 card and restores health to 20. - **A card pile can be crafted using paper and black dye.** When equipped in the corresponding trinket slot, it draws 2 cards per minute in survival or adventure mode until the number of cards in the inventory exceeds the player's maximum health. Additionally, the pile can store cards — see the item tooltip for usage details. - **In the screen opened by Left Ctrl + K, pressing the Delete key allows you to discard cards. Discarding 3 cards draws 1 new card.** ### Card Drawing Probability Implemented a simple Battle Expansion card deck (160 cards) like that in "Legend of Three Kingdoms". When the deck is depleted, it reshuffles and restores to 160 cards without affecting previously drawn cards. ### Card Usage - Basic cards can be automatically triggered in specific situations. "Dash," "Peach," and "Wine" can also be actively used by right-clicking for their effects.\ **(Note: The "Slash" card only triggers automatically if in the hotbar or offhand.)** - Scroll cards must be in the hand and used with a right-click. - Equipment cards must be equipped in the trinket slot to take effect. **Equipment trinkets cannot be manually removed; right-clicking while holding a new equipment item will replace the currently worn one.** ### Skill Acquisition Players receive one skill upon first entering the world. Every 5 minutes, players can change their skill by holding the new skill in the offhand and sneaking while right-clicking.\ Additionally, throwing 64 emeralds to a Nitwit villager will generate a gift box. Holding gold ingots or gold blocks in the offhand while opening the gift box grants a chance to obtain a skill (for a higher probability, hold multiple gold blocks — otherwise, it's just wasting gold). ### Skill Usage **All skills must be equipped in the skill trinket slot to be activated!** - Active Skills need to be used by pressing the J hotkey (configurable). They activate when conditions are met. When multiple active skills exist, long-press the hotkey to select priority skills. - Passive Skills will automatically trigger when conditions are met. - Since Minecraft is not turn-based, skill usage is limited. Some skills share cooldowns, while others have independent cooldowns. ### Miscellaneous - All "Legend of Three Kingdoms" equipment (weapons, armor, and horses) and skills have dedicated trinket slots and must be equipped in these slots to be effective. The items in the skill and card pile trinket slots do not drop upon death. - Equipping skills, weapons, or other trinkets will notify all players. - Use the command `/dabaosword info ` to check a target player's equipment and skills. **Press Left Ctrl + I to quickly view the nearest player's info.** - Upon death, all cards are cleared (even if keepInventory gamerule is true). Upon respawn, players draw 1 "Slash," 1 "Dash," 1 "Peach," and 1 random card. ### Game Rules **card_pile_hungerless:** Whether the card pile prevents hunger from decreasing (default: off).\ **clear_cards_after_death:** Whether to clear all cards upon death (default: on). If disabled, cards will drop normally on death, and no new cards will be given on respawn.\ **give_card_interval:** Interval for card pile distribution (in seconds). Default is 2 cards every 60 seconds, with a minimum of 1 second.\ **change_skill_interval:** Interval for skill changes (in seconds). Default is 5 minutes. Setting to -1 disables skill refreshes.\ **enable_cards_limit:** Whether to limit card pile distribution (if the number of cards exceeds the player's max health, auto-distribution stops). Default: on.

中文介绍

## 主要内容 ### 身份模式（v0.6）一个根据三国杀身份模式设计的3阵营不对称pvp玩法。\ 在游戏内，玩家可以通过使用指令`/dabaosword`或者 **同时按下左Ctrl和M键（若快捷键占用，请尝试在聊天界面按下）** 打开由文本组件组成的快捷菜单，点击其中的【新建游戏】，即可查看游戏规则和选择模式。\ 尝试创建对战时，系统会以玩家为中心，将附近20格（范围可以通过配置文件修改）内的其他不处于对战中的玩家拉入同一局对战。需要至少两名玩家才可以创建对战。\ 成功创建对战后，会进入10秒（等待时间可配置）等待倒计时。在准备阶段，任意一名参与对战的玩家均可以通过打开聊天栏点击【拒绝加入】而放弃加入，然后对战不会开始。\ \ **以下是详细的身份模式对战规则：（可在游戏内查看）** 1. 阵营分配：游戏开始时，随机为每位玩家分配身份，身份信息仅对自己可见。3名及以上玩家参与时，其中一半人（向下取整）为反贼，1人为内奸，余下玩家为忠臣，共3个阵营。 2. 阵营生命：玩家死亡后可以复活，直到该阵营生命数量耗尽。不能再复活的玩家公布身份，旁观游戏。反贼阵营按人均3条命计，其他阵营玩家的生命数之和等于反贼阵营玩家生命数之和（如5人游戏，两名反贼共6条命，忠臣阵营6条命，内奸6条命；6人游戏，3名反贼共9条命，忠臣阵营2人共9条命，内奸9条命）。 3. 得分规则：忠臣击杀反贼得1分，反贼击杀忠臣得1分，内奸击杀忠臣或反贼均可得1分，忠臣和反贼击杀内奸或队友不得分。 4. 获胜条件：当忠臣或反贼阵营的成员全部被淘汰后，若仅存一队，则该队获胜；若还剩两队（内奸与忠臣或反贼），得分更高的阵营获胜，如果得分相同，则继续游戏，直到内奸得分（内奸胜）或死亡（另一队胜），游戏结束。 5. 超时规则：游戏过程中，若长时间（可通过配置文件修改）无人得分，则游戏强制结束。此时若有唯一得分最高的阵营，其获胜（反之无人获胜）。 ### 摸牌机制 - 杀死敌对生物有较小概率（0.1）可以摸牌，杀死玩家能摸1张牌同时回复生命至20。 - **牌堆可以用纸和黑色染料合成**，装备在对应饰品栏时，在生存或冒险模式每分钟给持有者发两张牌，直到背包卡牌数量大于玩家最大生命值为止。此外，牌堆可以存放卡牌，具体使用方法见牌堆物品的物品提示。 - **在左Ctrl+K打开的界面内，按下delete键可以弃置卡牌，弃置卡牌达到3张时可摸一张牌。** ### 摸牌概率现已实现了一个简单的军争篇卡牌牌堆（160张牌），当牌堆的牌被摸光后，又会打乱牌堆，数量重新回到160张，之前摸到的牌不受影响。 ### 卡牌使用方式 - 基本牌可以在特定情况下自动触发，闪、桃、酒亦可主动右键使用以获得对应效果。\ **（注意：杀仅在快捷栏或者副手才会自动触发，位于其他位置禁用）** - 锦囊牌均需拿在手上，右键方可使用。 - 装备牌需要装备在饰品栏才可以生效。**装备类饰品不可以主动脱下，手持装备类饰品右键使用可以替换之前穿戴的装备。** ### 技能获取方式第一次进入存档可以获得一个技能；每过5分钟，玩家可以更换技能，更换方式为：副手拿技能，潜行右键。\ 此外，将一组绿宝石扔给傻子村民，会产生一个礼盒，副手持金锭或金块以打开礼盒，有概率获得技能（如果想提高获得技能的概率，那就副手多放些金块，否则就白氪金了）。 ### 技能使用方式 **所有技能均需要装备在技能饰品栏才可以发动！** - 主动技需按下快捷键J使用（可自由修改），满足条件即可发动，若有多个主动技，长按该按键可以选择优先发动的技能； - 被动技满足条件就会自动触发； - 由于 MC 不是回合制，为了限制技能发动，部分技能有 CD，其中部分技能共享 CD，部分技能有独立 CD。 ### 杂项 - 所有三国杀的装备（武器、防具和马匹）和技能都有专门的饰品栏，且需要装备在饰品栏才能生效。其中，技能和牌堆饰品栏的物品是死亡不掉落的。 - 玩家装备技能、装备等饰品后，会通知所有玩家。 - 可以用命令`/dabaosword info `查看目标玩家的装备和技能。**按下左Ctrl+I可以快速查看距离最近的其他玩家的信息**。 - 玩家死亡后，清空所有卡牌（即使开了死亡不掉落），复活后，获得杀、闪、桃各一张以及一张随机牌； ### 游戏规则 **card_pile_hungerless:** 牌堆是否能保持饱食度为20，默认关闭。\ **clear_cards_after_death:** 死亡后是否清除所有卡牌，默认开启，若关闭，死亡后牌会正常掉落，复活后不会给牌。\ **give_card_interval:** 牌堆发牌时间间隔（单位：秒），默认60秒发两张牌，最小值为1。\ **change_skill_interval:** 更换技能时间间隔（单位：秒），默认5分钟。设置成-1时，不会刷新更换技能的机会。\ **enable_cards_limit:** 是否限制牌堆发牌（若手牌数大于生命上限则停止自动发牌），默认开启。\ 另见：[MC mod 百科 - 大宝刀](https://www.mcmod.cn/class/14332.html)

getItemFromBlock

Create: Tweaked Controllers

CC: Advanced Math