写在前面：

1.需要是小数形式，即使是1也要写成1.0的形式记为浮点数，如无专门声明则是整数形式或true/false（布尔值）。

2.橙色加粗为大类，蓝色为配置项，浅绿色为描述，紫色为值的范围或格式，不要纠结颜色的名字严不严谨这种细节啦。

3.大类的命名方式参考配置文件，[顶级类.二级类.三级类......]。

4.[小白难点]这点写给需要修改含列表的小白。实体列表、物品列表、状态列表......的格式: ["mod的注册名:实体id/物品id/状态id","mod2的注册名:实体2的id/物品2的id/状态2的id",......,"modn的注册名:实体n的id/物品n的id/状态n的id"]，如做为实体时的盔甲架id为：["minecraft:armor_stand"]，实体id可以在站内搜索对应生物的名称，从实体命令中获取实体id与mod注册名。如龙之生存的骑士的实体id：

/summon dragonsurvival:knight ~ ~1 ~

dragonsurvival:knight即为其实体id，即为：["dragonsurvival:knight"]。注意：要区分好状态id、实体id、物品id的区别，最简单的区别在于若在给于玩家物品的指令/give中使用实体id或状态id将会报错，请确保报错不是因为命令别的地方打错了；不要漏了逗号且一定确保使用的是半角（英文输入法下。一个名叫Visual Studio Code的轻量级代码编辑器会把中文输入法下的字符用黄色框框出以帮助你检查）的[],""。如果还是听不懂建议先去了解一些关于指令的知识。

5.由于配置项繁多，难免出现遗漏现象，如果有遗漏欢迎协助补充。

6.协助编写请勿直接机翻。

本教程编写时所用的：

DragonSurvival：1.20.1-18.07.2024

Minecraft：1.20.1

forge：47.3.6

Visual Studio Code编辑器： 1.88.1

Visual Studio Code插件CodeGeeX：2.15.1

目前更新至：[magic.abilities.sea_dragon.actives.ball_lightning]的ballLightning。

龙之生存的服务端配置项主要有两种方式打开，这两种方式本质上实际都一样，但第一种不太稳定，有时候会玄学崩溃，推荐使用第二种：

1、游戏内在有op权限时打开龙的物品栏找到设置。

优点：方便、在列表添加原版的物品/实体时有自动提示和图标、电脑小白友好。

缺点：不稳定。

首先按“E”键打开原版物品栏，然后打开“龙的物品栏”。

打开设置。

然后点击服务端设置即可看到，目前该界面没有汉化。单机模式中打开该界面会暂停游戏。

由于本质上和修改配置文件一样，因此每个项将在第二种方式中统一讲解。

2、游戏外查看toml配置文件。

优点：稳定、对有一定技术功底的玩家友好、扩展性强。

缺点：对电脑小白不友好、游戏外编辑、正常情况下没有自动提示。

配置文件是saves\存档名\serverconfig下的dragonsurvival-server.toml，本教程使用Visual Studio Code软件打开配置文件，也可以使用记事本打开。

若无特殊声明不需要加单引号或双引号。

true意为“开”，false意为“关”，是配置文件中常用的配置项的值。

[wings]翅膀

flightHungerTicks：悬停飞行时多久消耗一点饥饿值/饱和度（饥饿值与饱和度的机制不懂的自行搜索）。范围1~72000，单位：刻（一刻=0.05秒），默认：50。

stableHover：悬停是否应该类似于创造模式飞行一样完全稳定。范围：true/false，默认：false。

flightSpinCooldown：横滚的冷却时间。范围0~100000，单位：秒，默认：5。

alternateFlight：是否使用类似于创造模式的飞行而不是滑行。范围：true/false，默认：false。

foldWingsOnLand： 在着陆时，是否自动关闭翅膀。范围：true/false，默认：false。

lethalFallDamage：从飞行中掉落是否致命，设置为false会让你至少剩下半颗心1点（）。范围：true/false，默认：false。

enableFlightFallDamage：在飞行时是否受到掉落伤害。如果为false，龙在展开翅膀时将免疫掉落伤害。但是在本教程编写时发现无论是true或false皆不能实现实现“让你至少剩下半颗心”。范围：true/false，默认：true。

flyingUsesHunger：飞行时是否消耗饥饿值。范围：true/false，默认：true。

flightHungerThreshold：玩家能打开翅膀的最低饥饿值。范围：0~20，单位：饥饿值，默认：6点（）。

allowFlyingWhenTotallyHungry：是否允许在饥饿值耗尽时飞行。范围：true/false，默认：false。

enderDragonGrantsSpin：是否可以和末影龙对话获得横滚或特殊物品。原注释为：“Whether you should be able to obtain the spin ability from t-he ender dragon or take special item.”但不清楚“特殊物品（special item）”指的是什么且没观察到其出现。范围：true/false，默认：true。

startWithLevitation：龙是否出生时就可以使用浮空魔法（即飞行），如果设为false，在玩家试图开启翅膀时聊天栏会显示“你现在还没有翅膀。去找末影龙谈谈吧”且enderDragonGrantsSpin项为true则在首次与末影龙对话后获得翅膀，若皆为false，正常情况下无法获取飞行能力。范围：true/false，默认：true。

maxFlightSpeed：最大飞行加速度，值越大速度越快，考虑到区块加载速度。速度为0.3（默认）时最合适。范围：0.1~1.0（浮点数），默认：0.3。

levitationAfterEffect：在浮空效果结束后，翅膀禁用多少秒（如：潜影贝的攻击）。范围：0~60，单位：秒，默认3。

unlimitedFlightAcceleration：是否启用旧版的飞行物理，具有无限加速度（bug），可能导致服务器卡顿和速度过快。范围：true/false，默认：false。

[magic]魔法

baseBreathRange：基础吐息伤害（随着龙的成长，吐息伤害会增加）。范围：0~10，单位：点，默认：3点（）。

passiveScalingCost：被动技能等级每升高一级消耗的经验增长。范围：0.0~100.0（浮点数），单位：级，默认：6.0。

initialPassiveCost：被动技能升级基础经验值消耗，第一次升级被动技能时的经验消耗为：passiveScalingCost项的值+initialPassiveCost项的值，此后i-nitialPassiveCost项不再起作用。范围：0~100，单位：级，默认：4。

noEXPRequirements：关闭主动技能升级的经验要求。范围：true/false，默认：false。

seaDragonAbilities：是否启用海洋龙的魔法能力。范围：true/false，默认：true。

forestDragonAbilities：是否启用森林龙的魔法能力。范围：true/false，默认：true。

caveDragonAbilities：是否启用洞穴龙的魔法能力。范围：true/false，默认：true。

dragonAbilities：是否启用龙的魔法。范围：true/false，默认：true。

[magic.abilities]魔法->能力

saveAllAbilities：是否在切换龙类型时保存所有被动技能。范围：true/false，默认：false。

[magic.abilities.sea_dragon]魔法->能力->海洋龙

[magic.abilities.sea_dragon.passives]魔法->能力->海洋龙->被动技能

water：是否启用海洋龙的被动技能。范围：true/false，默认：true。

spectralImpactProcChance：被动技能幽光震荡（spectral impact）的触发概率。该项数值乘以技能等级为最终概率。范围：0~100，单位：百分比%，默认：15。

spectralImpact：是否启用幽光震荡。范围：true/false，默认：true。

seaMagic：是否启用海洋魔力。范围：true/false，默认：true。

seaAthletics：是否启用海洋健将能力。范围：true/false，默认：true。

[magic.abilities.sea_dragon.actives]魔法->能力->海洋龙->主动技能

[magic.abilities.sea_dragon.actives.storm_breath]魔法->能力->海洋龙->被动技能->雷霆之息

chargedBlacklist：不会受到带电效果的实体列表，该项会自动将大部分其它mods中应该也不会受到带电效果的实体加入进来；通过信雅互联加入的mo-ds也可以。格式：见“写在前面第四点”，默认：["minecraft:armor_stand", "minecraft:cat", "minecraft:cart", "minecraft:guardian", "minecraft:elder_guardian", "minecraft:enderman"]。

chargedSpreadBlacklist：不受spread charged effect（带电效果延伸出去的电流，截止本教程，mcmod.cn上还没有其独立的资料)的实体列表）。格式：同上一项，默认：同上。

chargedEffectDamageMultiplier：带电效果的伤害，1点（）+（该项的值*带电效果等级）。范围：0.0~100.0（浮点数），单位：点血量，默认：1.0。

chargedChainRange：带电效果连锁传播的最大距离，过大的数值容易造成卡顿。范围：0~100，单位：块，默认：4。

chargedEffectMaxChain：带电效果能够连锁传播的最大实体数量，设为-1将禁用。范围：-1~100，单位：个，默认：5。

chargedEffectChainCount：雷霆之息能够链式传播的实体数量。范围：0~100，单位：个，默认：2。

stormBreathBlockBreaks：雷霆之息能够破坏的方块。格式: 见“写在前面第四点”，默认：["minecraft:impermeable", "minecraft:flowers", "minecraft:replaceable_plants"]。

stormBreathManaTicks：雷霆之息消耗魔力的频率。范围：0.0~100.0（浮点数），单位：点魔力/秒，默认：2.0，前面说Ticks后面说秒是吧。

stormBreathOvertimeMana：施展雷霆之息所需的魔力。范围：0~100，单位：点魔力，默认：1。

stormBreathCasttime：雷霆之息所需的施法时间。范围：0.05~10000.0（浮点数），单位：秒，默认：1.0。

stormBreathCooldown：雷霆之息的冷却时间。范围：0.05~10000.0（浮点数），单位：秒，默认：10.0。

stormBreathDamage：此值*技能等级=雷霆之息造成的伤害。范围：0.0~100.0（浮点数），单位：点血量，默认：1.0。

stormBreath：是否启用雷霆之息。范围：true/false，默认：true。

[magic.abilities.sea_dragon.actives.sea_vision]魔法->能力->海洋龙->被动技能->水下远视

seaVisionManaCost：使用水下远视所需的魔力消耗。范围：0~100，单位：点魔力，默认：1。

seaEyesCasttime：水下远视的施法时间。范围：0.05~10000.0（浮点数），单位：秒，默认：1.0。

seaVisionCooldown：水下远视的冷却时间。范围：0.05~10000.0（浮点数），单位：秒，默认：60.0。

seaVisionDuration：使用水下远视能力时给予的效果持续时间，持续时间=该值*技能等级。范围1.0~10000.0，单位：秒，默认：100.0。

seaVision：是否启用水下远视。范围：true/false，默认：true。

[magic.abilities.sea_dragon.actives.revealing_the_soul]魔法->能力->海洋龙->被动技能->灵魂掠夺

revealingTheSoulMultiplier：灵魂掠夺所能增加的经验量，额外经验值是在正常掉落的基础上增加的。1.0=增加一倍。范围：0.0~10000.0（浮点数），单位：倍，默认：1.0。

revealingTheSoulMaxEXP：灵魂掠夺所能增加的经验量上限。范围：0~10000，单位：点经验，默认：20。

revealingTheSoulManaCost：灵魂掠夺的魔力消耗。范围：0~100，单位：点魔力，默认：1。

revealingTheSoulCasttime：灵魂掠夺的施法时间。范围：0.05~10000.0（浮点数），单位：秒，默认：1.0。

revealingTheSoulCooldown：灵魂掠夺的冷却时间。范围：0.05~10000.0（浮点数），单位：秒，默认：30.0。

revealingTheSoulDuration：使用灵魂掠夺时给予的效果持续时间，在不更改其它配置项的情况下该技能1级与4级没有区别，效果不会随技能等级变化。范围：1.0~10000.0（浮点数），单位：秒，默认：200.0。

revealingTheSoul：是否启用灵魂掠夺。范围：true/false，默认：true。

[magic.abilities.sea_dragon.actives.ball_lightning]魔法->能力->海洋龙->被动技能->雷霆爆裂弹好中二

ballLightningManaCost：使用雷霆爆裂弹的魔力消耗。范围：0~100，单位：点魔力，默认：1。

ballLightningDamage：雷霆爆裂弹的伤害值。此值*技能等级=伤害。范围：0.0~100.0（浮点数），单位：点血量，默认：4点（）。

ballLightningCasttime：雷霆爆裂弹的施法时间。范围：0.05~10000.0，单位：秒，默认：2.0。

ballLightningCooldown：雷霆爆裂弹的冷却时间。范围：0.05~10000.0，单位：秒，默认：20.0。

ballLightning：是否启用雷霆爆裂弹。范围：true/false，默认：true。