Azitate
本帖最后由 秋风残叶 于 2022-10-14 19:49 编辑





QuantumRPG4.0+
维基翻译[[/]]插件教程

前言
F E I H U A
该WIKI仅适用于QRPG5.0以下版本
5.0作者重新编辑了WIKI,请自行查看原WIKI或等待我更新
本次WIKI翻译由我一人负责
作者的WIKI写的较为抽象难懂且缺少了部分内容
若完全参照WIKI翻译我可能自己都不能理解插件的功能
因此我会在最大限度保留作者原WIKI内容的同时
以自己在使用中的理解来为各位介绍这款插件
并将WIKI中缺漏的一小部分项目补全
因部分翻译取自我自己的理解
翻译内容可能会出现偏差 若您发现了问题请及时提醒我更改
文章内容较为复杂 若你想真正了解插件请仔细阅读
具体每个字符串的讲解我都写在了代码粘贴行中
推荐一个模块一个模块的阅读并根据插件文件夹中的配置一起理解学习
在阅读本文章时请确保你有一定的理解能力我说话真的确实比较抽象
如何你有任何问题可前往搬运贴下方回复询问或前往spigotmc与作者联系
目录可能会出现跳转问题|若出现问题请自行手动查看
本帖将不会解答任何插件使用问题
该WIKI仍在不断完善中

[站内插件搬运贴]
[旧版本WIKI|BY@longlongz]
目录
L I S T
链接
L I N K
Azitate
本帖最后由 Azitate 于 2019-8-4 23:06 编辑

主要配置文件
C O N F I G
| 语言与快捷命令设置 |
  1. core:
  2. #语言文件设置
  3.   lang: cn
  4. #快捷命令设置（输入这些命令可以快速打开插件帮助信息用“,”号隔开）
  5.   command-aliases: quantumrpg,qrpg,di,divineitems
复制代码
| 插件用户数据存储设置 |
  1. data:
  2. #自动存储队伍等玩家数据的时间(分钟为单位),设置成0关闭自从存储
  3.   auto-save: 15
  4. #使用的存储方式,可选SQLite或者MySQL
  5.   storage:
  6.     type: sqlite
  7. #以下为Mysql存储才用到的设置
  8.     username: none
  9.     password: none
  10.     host: none
  11.     database: none
  12. #是否自动清理长时间不上线玩家的数据
  13.   purge:
  14. #是否启用该功能
  15.     enabled: false
  16. #清理多少天不上线玩家的数据
  17.     days: 60
复制代码
| 插件hook设置 |
  1. #HOOK设置
  2. general:
  3. #等级插件HOOK设置
  4. #使用该功能请确保你的服务器安装了QRPG和要挂钩的等级插件
  5. #可以设置成NONE来关闭插件挂钩
  6. #挂钩的等级插件如BattleLevels, Heroes, mcMMO, PvPLevels, SkillAPI, Skills, PlayerLevels等
  7. level-plugin: NONE
  8. #职业插件HOOK设置
  9. #使用该功能请确保你的服务器安装了QRPG和要挂钩的职业插件
  10. #可以设置成NONE来关闭插件挂钩
  11. #挂钩的职业插件如Heroes, Races of Thana, SkillAPI, Skills.
  12. class-plugin: NONE
复制代码
| 伤害公式设置 |
  1. #自定义伤害公式
  2. #可用变量如下
  3. #%dmg% - 伤害数值 (这里指计算伤害与防御的数值之后打出的最终伤害)
  4. #%pvpe_dmg% - PvP 或 PvE 伤害数值 (具体取决于实体类型)
  5. #%pvpe_def% - PvP 或 PvE 防御树脂 (具体取决于实体类型)
  6. #%crit% - 暴击伤害
  7. #%block% - 受到伤害的百分比数
  8. damage-formula: '%dmg% * ((1 + (%pvpe_dmg% - %pvpe_def%) / 100) * (1 - %block% / 100))'
复制代码
| 杂项I设置 |
  1. #伤害冷却修正,如果玩家使用武器还在冷却状态(鼠标指针下的剑图标)中
  2. #他再次攻击造成的伤害比,如果调整成0就是不造成伤害,这里推荐大部分RPG服务器修改成0.5比较好
  3. damage-reduce-by-cooldown: 0.0
  4. #有耐久的物品当耐久为0时物品是否消失,设置成false则为不消失但无法使用,直到你修复它才可继续使用
  5. break-items: true
  6. #设置鼠标指针与指示的目标方块的最大距离,此设置是应用于下面攻击/防御类型中的自定义on-hit-actions这个选项
  7. max-get-target-distance: 30
复制代码
| Lore格式设置 |
  1. #Lore的格式
  2. #这里主要是你使用指令添加属性之后的显示格式,而且必须是这里的格式才能让属性什么的生效
  3. #%att_prefix% - 属性的前缀
  4. #%att_name% - 属性名
  5. #%att_value% - 属性数值
  6. #%type_prefix% - 伤害/防御/弹射物类型前缀
  7. #%type_name% - 伤害/防御/弹射物/手持类型名称
  8. #%type_value% - 伤害/防御/弹射物类型数值
  9. lore-format:
  10. #属性格式
  11. item-stat: '%att_prefix% %att_name%: %att_value%'
  12. #伤害类型格式
  13. damage-type: '%type_prefix% %type_name%: %type_value%'
  14. #防御类型格式
  15. armor-type: '%type_prefix% %type_name%: %type_value%'
  16. #弹射物弹药格式
  17. ammo-type: '&7弹射物类型: %type_prefix% %type_name%'
  18. #手持格式
  19. hand-type: '&7手持类型: %type_name%'
复制代码
| 杂项II设置 |
  1. #数值显示是否取整数?
  2. round-to-integer: false
  3. #物品属性是否对怪物有效
  4. item-stats-applies-to-mobs: true
  5. #是否允许钓鱼竿造成伤害
  6. fish-hook-can-damage: true
  7. #属性是否在副手生效
  8. item-stats-applies-in-offhand: false
  9. #当设置为true时,怪物和NPC所穿装备的耐久可以被消耗
  10. mobs-can-reduce-item-durability: true
  11. #是否允许SKP的技能减少装备的耐久
  12. skill-api-skills-can-reduce-item-durability: true
  13. #弓箭物品左键攻击怪物是否造成伤害?(指添加的属性等效果是否有效,建议关闭这个功能)
  14. allow-bows-melee-damage: false
  15. #如果为false,如果玩家背包有了一个不符合使用要求的物品,则禁止他手持该物品,作者默认给false我建议true
  16. allow-hold-items-you-cant-use: false
  17. #禁用高版本中的武器横扫效果,这样没有AOE属性的武器就不能同时攻击多个目标了
  18. disable-vanilla-sweep-attack: false
  19. #战斗设置
  20. combat:
  21. #设置添加在盾牌BLOCK_RATE属性的最大值
  22. shield-block-add-rate: 50.0
  23. #设置添加在盾牌BLOCK_DAMAGE属性的最大值
  24. shield-block-damage: 50.0
  25. #盾牌防御成功一次后，再次使用所需要的冷却时间（秒）
  26. shield-block-cooldown: 5
  27. #减少因为伤害过高而造成大量的伤害粒子
  28. reduce-particle-hearts: true
  29. #将玩家物品栏上方的生命显示控制在10颗心(仅仅是视觉效果,实际上该多少血还是多少血)
  30. reduce-visual-player-hearts: false
复制代码
| 模块启用设置 |
  1. #模块设置,在这里你可以禁用量子RPG的模块功能
  2. modules:
  3. ACTIVE_ITEMS: true
  4. ARROWS: true
  5. BUFFS: true
  6. COMBAT_LOG: true
  7. CONSUMABLES: true
  8. CUSTOM_ITEMS: true
  9. DROPS: true
  10. ESSENCES: true
  11. EXTRACTOR: true
  12. FORTIFY: true
  13. GEMS: true
  14. IDENTIFY: true
  15. ITEM_HINTS: true
  16. LOOT: true
  17. MAGIC_DUST: true
  18. NOTIFICATIONS: true
  19. PARTY: true
  20. REFINE: true
  21. REPAIR: true
  22. RESOLVE: true
  23. RUNES: true
  24. SELL: true
  25. SETS: true
  26. SOULBOUND: true
  27. TIERS: true
复制代码
| 杂项格式设置 |
  1. #其他格式设置
  2. strings:
  3. #范围值符号
  4. dmg-separator: ' &7- '
  5. #耐久分割符号
  6. durability-separator: '&7/'
  7. #不可破坏类型物品的Lore
  8. durability-unbreakable: 不可破坏
  9. #百分比
  10. percent: '%'
  11. #负值
  12. negative: '&c'
  13. #正值
  14. positive: +
  15. #倍数符号
  16. modifier: x
  17. #分割线设置
  18. separator:
  19.     symbol: '&7/'
  20.     value-color: '&f'
  21. #物品使用需求格式
  22.   requirements:
  23.     #等级要求格式
  24.     level:
  25.       item:
  26.         #范围等级要求格式
  27.         range: '&c? 等级要求: %min%-%max%'
  28.         #整数等级要求格式
  29.         single: '&c? 等级要求: %min%+'
  30.       player: '%state%装备等级: %lvl%+'
  31.     #职业要求格式
  32.     class:
  33.       player: '%state%职业要求: %class%'
  34.       item: '&c? 物品类型: %type%'
复制代码
| 额外伤害类型增益设置 |
  1. #这里是指某些攻击类型对玩家/怪物造成的额外伤害百分比
  2. #比如下方例子中,poison这个伤害类型可以对怪物造成双倍数值伤害
  3. damage-modifiers:
  4.   ENTITY_ATTACK:
  5.     PLAYER: 1.0
  6.     MOB: 1.0
  7.   FIRE:
  8.     PLAYER: 1.0
  9.     MOB: 1.0
  10.   POISON:
  11.     PLAYER: 2.15
  12.     MOB: 2.0
复制代码
| 模块启用设置 |
  1. #手持设置
  2. hand-types:
  3.   ONE:
  4.     enabled: true
  5.     name: '&f单手'
  6.   TWO:
  7.     enabled: true
  8.     name: '&e双手'
复制代码
| 伤害类型设置 |
  1. #伤害类型设置
  2. damage-types:
  3.   #类型ID
  4.   physical:
  5.   #是否为所有物品的默认攻击类型
  6.   #这里只是你用所有物品造成的伤害都归于这个属性的控制范畴
  7.     default: true
  8.   #伤害类型Lore前缀
  9.     prefix: '&6?'
  10.   #伤害类型名称
  11.     name: 物理伤害
  12.   #数值的颜色符号
  13.     value: '&f'
  14.   #攻击动作
  15.   #详细设置请查看帖中的actions介绍
  16.     on-hit-actions: []
  17.   #环境伤害增强倍数,这个是指攻击不同生物群系中的生物
  18.   #造成的伤害倍数
  19.     biome-damage-modifier:
  20.       PLAINS: 1.0
  21.   #特定类型怪物伤害增强倍数
  22.   #对特定实体类型的怪物是否造成额外伤害
  23.   #暂未测试是否支持MOD生物不过想想也知道不支持
  24.     entity-type-modifier:
  25.       PIG: 1.0
  26.   #对特定MM怪派系造成的伤害倍数
  27.     mythic-mob-faction-modifier:
  28.       faction: 1.0
复制代码
| 防御类型设置 |
  1. armor-types:
  2.   #类型ID可以自定义
  3.   physical:
  4.   #伤害类型Lore前缀
  5.     prefix: '&6?'
  6.   #伤害类型名称
  7.     name: 物理防御
  8.   #数值的颜色符号
  9.     value: '&f'
  10.     #是否采用百分比
  11.     #添加属性后后面会跟一个%号
  12.     #但数值仍然是被你伤害公式控制的
  13.     #只能算是一个装饰类的?设置
  14.     percent: false
  15.     #可以防御的攻击动作
  16.     block-damage-source:
  17.     - ENTITY_ATTACK
  18.     #可以防御的攻击类型
  19.     block-damage-types:
  20.     - physical
  21.     #防御公式
  22.     #%dmg%造成的最终伤害
  23.     #%def%防御值
  24.     formula: (%dmg% - (%def% / 10))
复制代码
| 弹射物类型设置 |
  1. #弹射物类型
  2. #这里可以设置弓箭类武器射出去的弹射物种类
  3. #这里主要是配置弹射物类型添加后的前缀以及控制是否开启此类弹射物
  4. #你不能自己设置弹射物类型,所以没有什么太大的实际作用
  5. ammo-types:
  6.   ARROW:
  7.     enabled: true
  8.     prefix: '&f?'
  9.     name: 箭
  10.   SNOWBALL:
  11.     enabled: true
  12.     prefix: '&9?&f'
  13.     name: 雪球
  14.   EGG:
  15.     enabled: true
  16.     prefix: '&6?&f'
  17.     name: 鸡蛋
  18.   FIREBALL:
  19.     enabled: true
  20.     prefix: '&c?&f'
  21.     name: 火球
  22.   WITHER_SKULL:
  23.     enabled: true
  24.     prefix: '&8?&f'
  25.     name: 凋零头
  26.   SHULKER_BULLET:
  27.     enabled: true
  28.     prefix: '&d?&f'
  29.     name: 潜影贝导弹
  30.   LLAMA_SPIT:
  31.     enabled: true
  32.     prefix: '&e?&f'
  33.     name: 羊驼唾沫
  34.   ENDER_PEARL:
  35.     enabled: true
  36.     prefix: '&b?&f'
  37.     name: 末影珍珠
  38.   EXP_POTION:
  39.     enabled: true
  40.     prefix: '&e?&f'
  41.     name: 经验瓶
复制代码
| 镶嵌槽格式设置 |
  1. #这里是对于三大镶嵌槽设定
  2. socket-types:
  3.   GEM:
  4.     lore:
  5.     #没有镶嵌宝石时显示的Lore格式
  6.       empty: '&a□ <宝石槽>'
  7.       #镶嵌后显示的Lore格式
  8.       filled: '&a? &f'
  9.       #该格式仅限于Tiers中创建的物品,物品随机到宝石槽时添加的行
  10.       header: '&8&m&f「 宝石 」&8&m'
  11.   RUNE:
  12.     lore:
  13.       empty: '&b◇ <符文槽t>'
  14.       filled: '&b? &f'
  15.       header: '&8&m&f「 符文 」&8&m'
  16.   ESSENCE:
  17.     lore:
  18.       empty: '&c○ <特效石槽>'
  19.       filled: '&c? &f'
  20.       header: '&8&m&f「 特效石 」&8&m'
复制代码
| 属性设置 |
  1. #物品属性设置
  2. item-stats:
  3. #属性类型ID
  4.   DIRECT_DAMAGE:
  5.   #属性名称
  6.     name: 真实伤害
  7.     #属性前缀
  8.     prefix: '&f?'
  9.     #属性数值前缀
  10.     value: '&f'
  11.     #属性总计最大值
  12.     capability: 100.0
复制代码
| 物品子类型设置 |
  1. #物品类型,你可以自定义物品类型组,这里主要是在一些模块中
  2. #如宝石镶嵌的类型,你可以在写宝石时直接填写类型ID来限制可镶嵌的物品类型
  3. item-sub-types:
  4. #类型ID
  5.   axe:
  6.   #类型名称
  7.     name: 斧
  8.     #物品类型
  9.     materials:
  10.     - WOODEN_AXE
  11.     - GOLDEN_AXE
  12.     - IRON_AXE
  13.     - DIAMOND_AXE
  14.     - STONE_AXE
  15.   sword:
  16.     name: 剑
  17.     materials:
  18.     - WOODEN_SWORD
  19.     - GOLDEN_SWORD
  20.     - IRON_SWORD
  21.     - DIAMOND_SWORD
  22.     - STONE_SWORD
  23.   shears:
  24.     name: 剪刀
  25.     materials:
  26.     - SHEARS
  27.   shovel:
  28.     name: 铲
  29.     materials:
  30.     - WOODEN_SHOVEL
  31.     - GOLDEN_SHOVEL
  32.     - IRON_SHOVEL
  33.     - DIAMOND_SHOVEL
  34.     - STONE_SHOVEL
  35.   pickaxe:
  36.     name: 镐
  37.     materials:
  38.     - WOODEN_PICKAXE
  39.     - GOLDEN_PICKAXE
  40.     - IRON_PICKAXE
  41.     - DIAMOND_PICKAXE
  42.     - STONE_PICKAXE
  43.   hoe:
  44.     name: 锄
  45.     materials:
  46.     - WOODEN_HOE
  47.     - GOLDEN_HOE
  48.     - IRON_HOE
  49.     - DIAMOND_HOE
  50.     - STONE_HOE
  51.   helmet:
  52.     name: 头盔
  53.     materials:
  54.     - GOLDEN_HELMET
  55.     - IRON_HELMET
  56.     - DIAMOND_HELMET
  57.     - CHAINMAIL_HELMET
  58.     - LEATHER_HELMET
  59.   chestplate:
  60.     name: 护甲
  61.     materials:
  62.     - GOLDEN_CHESTPLATE
  63.     - IRON_CHESTPLATE
  64.     - DIAMOND_CHESTPLATE
  65.     - CHAINMAIL_CHESTPLATE
  66.     - LEATHER_CHESTPLATE
  67.   leggings:
  68.     name: 护膝
  69.     materials:
  70.     - GOLDEN_LEGGINGS
  71.     - IRON_LEGGINGS
  72.     - DIAMOND_LEGGINGS
  73.     - CHAINMAIL_LEGGINGS
  74.     - LEATHER_LEGGINGS
  75.   boots:
  76.     name: 靴子
  77.     materials:
  78.     - GOLDEN_BOOTS
  79.     - IRON_BOOTS
  80.     - DIAMOND_BOOTS
  81.     - CHAINMAIL_BOOTS
  82.     - LEATHER_BOOTS
  83.   elytra:
  84.     name: 鞘翅
  85.     materials:
  86.     - ELYTRA
  87.   shield:
  88.     name: 盾
  89.     materials:
  90.     - SHIELD
  91.   bow:
  92.     name: 弓
  93.     materials:
  94.     - BOW
  95.   fishing_rod:
  96.     name: 鱼竿
  97.     materials:
  98.     - FISHING_ROD
复制代码
| 物品组设置 |
  1. #这里主要是设置哪些物品是武器,哪些物品是装备
  2. #个人感觉最大作用于tiers功能,tiers默认是不支持mod物品的
  3. #你可以F3+H查看物品的类名添加到下方
  4. item-groups:
  5.   WEAPON:
  6.     name: 武器
  7.     materials:
  8.     - WOODEN_SWORD
  9.     - WOODEN_AXE
  10.     - STONE_SWORD
  11.     - STONE_AXE
  12.     - GOLDEN_SWORD
  13.     - GOLDEN_AXE
  14.     - IRON_SWORD
  15.     - IRON_AXE
  16.     - DIAMOND_SWORD
  17.     - DIAMOND_AXE
  18.     - SHEARS
  19.     - FISHING_ROD
  20.     - BOW
  21.   TOOL:
  22.     name: 工具
  23.     materials:
  24.     - WOODEN_HOE
  25.     - WOODEN_AXE
  26.     - WOODEN_SHOVEL
  27.     - WOODEN_PICKAXE
  28.     - STONE_HOE
  29.     - STONE_AXE
  30.     - STONE_SHOVEL
  31.     - STONE_PICKAXE
  32.     - GOLDEN_HOE
  33.     - GOLDEN_AXE
  34.     - GOLDEN_SHOVEL
  35.     - GOLDEN_PICKAXE
  36.     - IRON_HOE
  37.     - IRON_AXE
  38.     - IRON_SHOVEL
  39.     - IRON_PICKAXE
  40.     - DIAMOND_HOE
  41.     - DIAMOND_AXE
  42.     - DIAMOND_SHOVEL
  43.     - DIAMOND_PICKAXE
  44.     - SHEARS
  45.     - FISHING_ROD
  46.   ARMOR:
  47.     name: 装备
  48.     materials:
  49.     - LEATHER_HELMET
  50.     - LEATHER_CHESTPLATE
  51.     - LEATHER_LEGGINGS
  52.     - LEATHER_BOOTS
  53.     - GOLDEN_HELMET
  54.     - GOLDEN_CHESTPLATE
  55.     - GOLDEN_LEGGINGS
  56.     - GOLDEN_BOOTS
  57.     - CHAINMAIL_HELMET
  58.     - CHAINMAIL_CHESTPLATE
  59.     - CHAINMAIL_LEGGINGS
  60.     - CHAINMAIL_BOOTS
  61.     - IRON_HELMET
  62.     - IRON_CHESTPLATE
  63.     - IRON_LEGGINGS
  64.     - IRON_BOOTS
  65.     - DIAMOND_HELMET
  66.     - DIAMOND_CHESTPLATE
  67.     - DIAMOND_LEGGINGS
  68.     - DIAMOND_BOOTS
  69.     - SHIELD
  70.     - ELYTRA
复制代码


Azitate
本帖最后由 Azitate 于 2019-8-5 09:13 编辑

指令
C O M M A N D
主命令:

· /qrpg help - 查看帮助
· /qrpg modify - 编辑物品
· /qrpg set - 设置物品
· /qrpg reload - 重载配置文件及模块
· /qrpg info - 插件信息
· /activeitems help - 自定义行为动作帮助
· /arrows help - 箭矢模块帮助
· /buffs help - Buff模块帮助
· /combatlog - 战斗日志模块帮助
· /consumables - 消耗品模块帮助
· /customitems help - 自定义物品模块帮助
· /drops help - 掉落模块帮助
· /essences help - 粒子石模块帮助
· /extractor help - 拆解模块帮助
· /fortify help - 保护石模块帮助
· /gems help - 宝石模块帮助
· /identifying help - 鉴定模块帮助
· /itemhints help - 物品显示模块帮助
· /loot help - 战利品盒模块帮助
· /magicdust help - 祝福之尘模块帮助
· /notifications help - 耐久提示模块帮助
· /party help - 组队模块帮助
· /refine help - 精炼模块帮助
· /repair help - 修复模块帮助
· /resolve help - 分解模块帮助
· /runes help - 符文模块帮助
· /sell help 出售模块帮助
· /sets help 套装模块帮助
· /soulbound help 灵魂绑定模块帮助
· /tiers help - 随机物品模块帮助

物品编辑命令:
· /qrpg modify name <名称> - 更改物品显示名称
· /qrpg modify lore add [信息] [行] - 添加Lore行
· /qrpg modify lore del [行] - 删除Lore行
· /qrpg modify lore clear - 删除物品的所有Lore
· /qrpg modify flag add <标签> - 添加物品标签
· /qrpg modify flag del <标签> - 删除物品标签
· /qrpg modify nbt add <NBT标签> <数值> - 添加NBT标签
· /qrpg modify nbt del <NBT标签> - 移除物品所有NBT
· /qrpg modify enchant <附魔> <等级> - 附魔物品
· /qrpg modify potion <药水效果> <等级> <时间> - 药水设置
· /qrpg modify color <r,g,b> - 设置皮革衣服的RGB颜色

物品设置命令:
· /qrpg set stat <类型> <数值> [行] - 设置物品属性
· /qrpg set level <等级> [行] - 添加等级要求
· /qrpg set class <职业> [行] - 添加职业要求
· /qrpg set damage <类型> <最小值> <最大值> [行] - 添加伤害类型
· /qrpg set defense <类型> <设置> [行] - 添加防御类型
· /qrpg set ammo <类型> [行] - 设置弓箭弹射物
· /qrpg set hand <类型> [行] - 设置手持类型
· /qrpg set socket <类型> [行] - 设置物品镶嵌槽



第一页 上一页 下一页 最后一页