Magespell

magespells

外文名	magespells
作者	L2_Envy
最新版本	2.3.7.2
源地址	https://www.spigotmc.org/resources/magespells-remastered.50430/

本条目已有一定量的内容，但仍需完善

欢迎参与本条目的完善工作。

你可以从以下几个方面入手

• 参阅格式化手册，并对该页面进行相应格式排版工作；
• 日常检查是否内容有更新版本并更新该页面；
• 修复该页面中已出现/潜在的问题

插件介绍

MageSpells是一款魔法插件.这款插件可以让你创造、使用魔法和法杖.

安装说明

在你安装此插件前,确认你已安装以下前置插件: Title Manager

Vault

ParticleAPI（1.10版本）或EffectLib(1.11版本以上) 可选前置:

WorldGuard

World Edit

插件安装

下载 MageSpells 把 MageSpells插件放到 plugin 文件夹. 重启服务器, 插件将会生成配置文件. 自定义你喜欢的配置文件. 自定义你喜欢的魔法和法杖. 并可设置消耗物品施法

特点

免费版本

该版本将不会继续更新

可以自定义魔法

可自定义法杖

法力系统
支持worldedit和worldguard
兼容的自定义配置可满足任何服务器的需求

付费版本

学习/魔法等级系统

可以自定义魔法
可自定义法杖
魔法系统
队伍系统
自定义物品
API（构建中）

更多的特性 支持worldedit和worldguard
兼容的自定义配置可满足任何服务器的需求

说明

你拥有越多的玩家和魔法, 对服务器的流畅度影响也会越大. 确保你的服务器有足够的CPU和内存. MageSpells 是用 Java 8+ 构建的并且支持 Minecraft 1.10以上的版本. 这个插件需要Particle API 和 Title Action Manager . 如果需要区域支持的话也需要World Guard和World Edit. (可选)

配置

可升级性(EnableLeveling)

魔法等级是解锁魔法的一种方式. 可以从怪物和其他玩家身上获取. 这对RPG服务器也许很有用. 它允许你掌控魔法书和法杖, 绑定魔法到法杖, 施法和合成魔法.

怪物经验(MobExperience)

怪物经验是一种关键的数值. 取决于怪物种类, 设置的数值就是能从该种怪物身上获取的魔法经验.

玩家经验(ExpFromPlayers)

这和怪物经验一样, 击杀其他玩家获得魔法经验.

等级系统(LevelSystem)

为了让等级系统正常运行,你需要设置等级.这意味着你需要设置每级升级所需的经验.你可以添加无限的等级.

升级的关键(The Key to Leveling)

这是另一个关键的系统. KEY可以是任何整数,数值为升级所需的经验数. 举个例子, 如果玩家拥有 1242 experience they will be level 5 because they have more than what is required for reaching level 5 but haven't gained enough experience to reach level 6 yet.

升级魔法的关键(The Key to Mana Leveling)

这也是另一个关键的系统. KEY 可以是任何整数, 数值为你想要设置的等级的魔法值. 举个例子, 如果玩家的等级为 1 - 他们的最大魔法值就为 50; 如果等级为 10 - 他们的最大魔法值就为 200. 这允许你每升一级的法力奖励来考虑更高的法力消耗 和/或 防止低级法力消耗法术的低级施放.

学习系统(EnableLearning)

学习也是一种解锁魔法的方法. 当你使用的魔法多了你会变得熟练, 同时保持RPG的特性. 这可以单独管理每个魔法，玩家使用了什么魔法. This is a more specific way to micromanage 玩家获得魔法. 对于使用牌子触发命令或其他触发指令的插件的服务器很游泳. 这也会开启学习魔法书和法杖的功能.

可通过魔法书学习魔法(EnableSpellBookLearning)

如果启用学习系统, 这一项也会起作用. 如果玩家不知道魔法, 右键魔法书的话, 这本魔法书会被消耗而玩家则学会了该魔法 (忽略魔法等级). 同时也可以使用该魔法.

学习使用法杖(EnableWandLearning)

和学习魔法书一样, 如果可学习性已开启, 这个也会被启用. 如果玩家右键未知的法杖, 他将会"学会"该法杖 (忽略魔法等级). 同时也可以使用该法杖来施法.

启用权限系统(EnableNodeSystem)

权限系统很复杂. 如果你不善于使用权限就不要启用这个. 这基于其他权限插件.
怎么使用? 每个魔法拥有各自的 '魔法权限节点' (magespells.spell.{node}) 每个法杖也有各种的 '法杖权限节点' (magespells.wand.{node}). 玩家想要施法或使用法杖必须要有这些权限.

所以这和学习系统差不多, 但权限系统能给魔法和法杖分成不同的组.
例如: 你拥有3个火焰魔法. 你设置了3个火焰魔法的权限为 'fire' (magespells.spell.fire).这意味着如果玩家拥有权限'magespells.spell.fire',他们就可以直接使用这3个魔法.
Wands work the exact same but with one added feature: Wands have a wandcompatibility node list. This list is where you can specify what spells will be compatible with that wand. So if you only want fire spells on a fire wand, in the wand compatability node list you will simply add '- fire'. This means all 3 of the spells mentioned above will be allowed to bind with the fire wand. This adds for so much diversity and simplicity for micromanaging your spells and wands.

队伍系统(UserCreatesTeam)

队伍系统是本插件的一大特色.
玩家组队就可以防止玩家误伤队友.这对于Faction派系插件很有用. 每个队伍拥有一名队长和officer. 想要创建队伍,必须要有有一名队长和officer. 如果队长想要加入到其他队伍,就必须退出当前的队伍.

魔法值上限(MaxManaAmount)

你可以修改每个玩家的魔法值上限.

魔法恢复率(ManaRegenRate)

魔法值会自然地持续恢复直到魔法值已满. 施法需要魔法值 (除非你把魔法消耗改为0). 它会按配置的速率逐渐恢复.

显示具体数值(Display Exact Value)

如果你想要玩家看得到自己有多少魔法值,启用这一项是最简单的方法.

颜色(Colors)

Colors is just an added way to choose what you want as a server admin- to blend MageSpells in with the color theme of your server. Purely cosmetic and doesn't effect gameplay in any way.

创造魔法

---

I'm not going to lie, as I'm typing this... I am not looking forward to going over every aspect of spells just because there is so much to customize. 
Nonetheless, these are the spells. Configurable masterpieces. Spells are created by simply creating a .yml file (generally named after the new spell 
you want to create), and copying and pasting the template into that .yml file. After you've done that, all you need to do is edit it to your liking. Be 
sure you look over everything so you know it's all working! Spell creating takes time and patience, but you will not be disappointed.

---

显示的名称(DisplayName)

Simply put, this is what the players will see in the spell menu and on the wand. Make it fancy! ;-)

描述(Lore)

用于魔法的lore.可以添加你想要的lore描述. 想要编辑下一行, 输入 '/' . 也支持颜色代码.

Bolt

Bolt spells are your basic spells that will stop when an enemy is hit. Bolt spells are great for long range spells.

Bolt Enabled

To Enable bolt spells, set this to true! This means the spell will inherit any characteristics of a bolt spell.

伤害范围(DamageRadius)

Damage Radius is when a bolt initially hits an enemy, anyone within the specified radius will be considered hit as well. BoltDamage

Bolt damage is simply put: 对玩家造成的伤害. 护甲值会减少玩家所受的伤害).

Aura

光环魔法 are great for affecting a wide range of players for a specific amount of time! Aura spells can be combined with bolt spells. If this is done, then at the end of a bolt spell's life, the aura spell will produce an aura. If you wish for the aura spell to happen at the player's location, just put the travel distance to '0'. Otherwise, the spell will fly until it hits a wall or runs out of distance, then activate.

启用光环(Aura Enabled)

Set this to true if you wish to inherit the characteristics of an aura spell.

持续时间(ActiveTime)

Aura spells operate differently than normal spells. An aura is active for a specific period of time. Set this in seconds for the aura to last that long. Aura spells will tick every second.

AuraRadius

This is the radius of the aura. Great for covering large amounts of land. Any person eligible to be affected will be in regards to the settings.

AuraDamage

This is where you can set the amount of damage an aura spell does. Armor is taken into affect)

Spray

喷溅魔法和bolt spells一样, but while they fly they don't stop when hitting an enemy (unless bolt is set to true). Instead, it damages anyone within the radius of the spell as it flies through the air. Note that enemies are only hit once by this spell.

Spray Enabled

Enable this to inherit the characteristics of the spray spell.

SprayRadius

This is the radius at which it affects people as it flies through the air. SprayDamage

This is how much damage each player is dealt. Armor is taken into affect.

护甲穿透(ArmorPiercing)

Armor can be a nasty pain in the butt. Let's eliminate that with armor piercing! Set this anywhere from 0-100. This will be taken as a percent to negate when the damage is dealt. So if a player has, let's say 50% armor, and the armor penetration is set to 20%, that means that only 40% of the armor is registered.

魔法消耗(ManaCost)

Mana cost is what spells run on (if you want). In order to cast a spell, the player must have this mana amount acquired, otherwise the spell will not be cast. see section 3.10

氪金(MoneyCost)

暂时还不支持 -- 花费金钱来施法,不会消耗魔法值! 需要安装Vault.

冷却(Cooldown)

If you want to limit how often a player can cast a spell, cooldowns are a great way to do this. This keeps players from rapid spamming a spell at other players, and helps keep things balanced.

充能时间(ChargeTime)

Charge Time is the same as cooldown time, but instead it operates befor a spell is cast. The charge time must tick all the way through, and then the spell is automatically cast. Mana is drained beforehand.

飞行距离(TravelDistance)

This is where you specify how far you wish the spell to travel (in units of blocks). If spells go past this distance, they are removed. Spells may end before this travel distance is reached.

魔法权限(SpellNode)

Spell Nodes (see section 3.8) are used for the node system. Put 'all' if not enabled.

绑定魔法等级限制(RequiredLevelToBind)

This level is required before a player can bind this spell to a wand. *Leveling system must be enabled.

施法等级限制(RequiredLevelToCast)

This level is required before a player can cast this spell. *Leveling system must be enabled.

掉落等级限制(RequiredLevelToDrop)

This level is required before an entity will drop this for a player. *Leveling system must be enabled.

AffectMobs

启用这个的魔法将会作用于所有怪物

影响自身(AffectSelf)

启用这个的魔法只对自己有效

影响敌人(AffectEnemy)

启用这个的魔法将会对除了队伍内的玩家外的所有生物起作用.

友军伤害(AffectTeammates)

启用这个的魔法将会对友军起作用.

特殊效果(SpecialEffect)

Special Effects are for any spells. If you are not sure what to put, set it to 'normal'. If you want to know what special effects there are, look at the effectlist.txt document. Here, I will add what new spell effects I have added. Spell effects do things like set enemies ablaze, or teleport the player.

音效

每个魔法都有一个音效.我喜欢使用Entity_Bat_Takeoff音效,这完全取决于个人偏好. 你也修改成其他音效.你可以在 SoundList.txt 内看到MC原版音效大全. 我添加了所有适用于1.10(及以上)版本的音效!

音效名(Name)

在这里放置音效名.

音量(Volume)

你可以修改音量

音调(Pitch)

你可以修改音调.让这个音效听起来截然不同.

粒子特效(Particles)

Particles are what give spells the fancy factor! You can make your spell stand out, or make it simple. Add as many particle effects as you want to your 
spell. Look at ParticleList.txt to see what particles are available to you! Particles are created every tick of the spell.

粒子栗子(Particle Example)

SMOKE_LARGE: // 粒子种类. When creating a new spell be sure to specify what particle followed by a colon.

Amount: 50 offSetX: 0.05 offSetY: 0.05 offSetZ: 0.05 Speed: 0.5

粒子数(Amount)

Here is where you put the amount of particles you wish to be spawned per tick.

offSet

The offset is, simply put, how far away you wish the particles to be spread from the center. Meaning if you have 0.05, that means the particles will expand 0.05 blocks on the x/y/z axis.

粒子速度(Speed)

Speed is how fast you want the particles to go through their animation. Meaning they will speed up and disappear the faster you set it.

药水效果(Potion Effects)

Potion Effects are just like the potions in vanilla minecraft. Each one has a name to be identified by. Use the potioneffectlist.txt document to figure out what potion effect you'd like to add.

药水效果例子(Potion Effect Example)

WEAKNESS: // Just like particle effects, be sure to specify what potion effect, followed by a colon.

Duration: 50 Amplification: 0.5

持续时间(Duration)

药水效果的持续时间.

Amplification

Amplification is how strong the potion effect will be. Some potion effects can only go to 2, so be careful!

怪物掉落(Mob Drops)

Mob drops is used with binding and spell learning. In order to bind a spell, you must have a spellbook present in your inventory. To get these spellbooks, you must kill mobs (if you want). This is where you set the chance a certain mob has to dropping the book.

开启怪物掉落(Enabling Mob Drops)

If you'd like to gain spellbooks through mob drops, then set this to true.

怪物掉落例子(Mob Drop Example)

BLAZE: // Mob type -- be sure to specify the type of mob you want to drop the spell.

Chance: 1.0

关键数值:掉率(Key-Value Chance Rate)

This works as a KEY-VALUE set. The KEY here is the MOB and the VALUE is the chance (which represents a percentage value). For example: 1.0 would be 1% chance and 100.0 would be 100%. Note: You can only go as low as 1% chance.

物品消耗(Item Cost)

Item Costs allow for more complexity when attempting to cast a spell. If a player doesn't have the specified items in his/her inventory, then the spell will not be cast. The Item Costs work with custom items, meaning you can make it so a player requires a custom item to cast a spell. Use the MaterialsList.txt document to get a list of materials. To specify a specific material that has a data key to it, use a hyphen. Example: 'wool-3' would be 'Light Blue Wool'. For a list of specific ID's use this Minecraft-IDs Website or /itemdb in MC.

启用物品消耗(Enabling ItemCost)

Enable ItemCost if you wish to have custom item costs for the spell, meaning you want the spell to cost items to use. Setting Up and ItemCost Item

This also works as a KEY-VALUE pair. The KEY is the item and the VALUE is how much of the item it takes (or COSTS) to power the spell.

创造法杖

Wands are what allow users to cast spells. Without these, there is no magic (qeue bad music). Wands can hold up to two spells - a Primary and a 
Secondary. To initiate a Primary spell, simply left click in the direction you wish it to go. For the Secondary spell, just right click and watch it 
fly. Wands are learnable and require levels or permission nodes to use (depending on how you set it in the config).

魔法名称(Name)

This is where you put the display name of the spell. Make it fancy as color codes are welcome!

等级合成限制(RequiredLevelToCraft)

In order to craft a wand, a player must first have the required level or above. They will also need to have learned the wand and have the permission node, depending on how you set it up in the config.

等级使用限制(RequiredLevelToUse)

In order to use a wand (cast a spell), a player must first have the required level or above. They will also need to have learned the wand and have the permission node, depending on how you set it up in the config.

绑定魔法等级限制(RequiredLevelToBind)

In order to craft a wand, a player must first have the required level or above. They will also need to have learned the wand and have the permission node, depending on how you set it up in the config.

法杖材质(WandMaterial)

In order to craft a wand, a player must first have the required level or above. They will also need to have learned the wand and have the permission node, depending on how you set it up in the config.

合成配方(Recipe)

Recipes is where you specify how to make a wand. Each spot refers to a spot in a crafting table. [1][2][3] -- This is the crafting table. In terms of the config, it goes by position. [4][5][6] -- 1,2,3,4,5,6,7,8,9 - Each number should be replaced by some sort of material type. [7][8][9] -- Materials with data values are allowed, simply use a hyphen. Example: Wool-3 would be Light Blue Wool.

If you don't wish to have anything in the spot, simply put 'AIR'. Please note: for recipes, minecraft does not store specific data like lore and display name. With that said, custom items will NOT be recognized in the recipe.

For a list of specific ID's use: Minecraft-IDs Website or /itemdb in MC.

Mob Drops

Mob drops is used with binding and wand learning. In order to bind a spell to the wand, you must have a compatible wand present in your inventory. To get these wands, you must kill mobs (if you configure this to do so) or craft them. This is also where you set the chance a certain mob has to dropping the wand.

Enable Mob Drops

Set this to true if you want wands to drop from mobs.

Example Mob Drop

BLAZE: // Mob type -- be sure to specify the type of mob you want to drop the spell.

Chance: 1.0

关键数值几率(Key Value Chance Rate)

This works as a KEY-VALUE set. The KEY here is the MOB and the VALUE is the chance (which represents a percentage value). For example: 1.0 would be 1% chance and 100.0 would be 100%. Note: You can only go as low as 1% chance.

法杖权限节点(WandNode)

Wand nodes (see section 3.7) are used for the node system. Put 'all' if not enabled.

兼容的魔法权限列表(CompatibleSpellNodeList)

Compatible nodes (see section 3.7), used for the node system. Put 'all' if not enabled.

创造自定义物品

Custom Items are great for item costs and things to just add into your server. They have their own crafting recipe and you can customize the display 
name and lore. Custom item creating only supports the leveling system right now, meaning you can only specify the player to be a certain level to be 
able to craft this item. I will eventually add node system and maybe learning into it.

物品名(Name)

This is where you can customize the custom item's display name for all players to see. Make it fancy ;-) Color Codes welcome!

描述(Lore)

This is where you put the lore for the custom item. Great to add lore, and anything else you wish. For a new line, type a '/' in there! Color codes welcome!

材质(Material)

This is where you specify the item material. Anything can be a custom item, but be careful. If the custom item is a block, it may be placed on right click and will lose all data value associated with it! Pick any material. Materials are listed in the MaterialList.txt document. Items with data values are accepted, simply use a hyphen. Example: Wool-3 would be Light Blue Wool. For a list of specific ID's use: Minecraft-IDs Website or /itemdb in MC.

合成配方(Recipe)

Recipes is where you specify how to make an item. Each spot refers to a spot in a crafting table. [1][2][3] -- 这是合成台的合成顺序. 可在配置内更改. [4][5][6] -- 1,2,3,4,5,6,7,8,9 - Each number should be replaced by some sort of material type. [7][8][9] -- Materials with data values are allowed, simply use a hyphen. Example: Wool-3 would be Light Blue Wool.

If you don't wish to have anything in the spot, simply put 'AIR'. Please note: for recipes, minecraft does not store specific data like lore and display name. With that said, custom items will NOT be recognized in the recipe.

For a list of specific ID's use: Minecraft-IDs Website or /itemdb in MC.

RequiredLevel

For a player to craft an item, they must be this required level or higher.

队伍

Teams are a great addition to MageSpells. They help sort players into groups so that spells will either hurt or help their teammates, depending on the spell settings. Teams can either be solely admin created, or user created. Example: If an admin wanted 4 factions, simply create 4 new teams and set yourself as leader. When a new player joins, simply have them click a server sign that will add them to a team.

队长(Leader)

This is where the leaders UUID of the team will be. It is important that it's a UUID and NOT the name! Leaders have full control over the team.

Officer

This is where the first officer will be, they have almost all the same permissions as the leader.

队员

Any other member will be added here. The have the option to leave the team. Simply put, it just shows when they are on a team. Each user can only be on one team. Bot the name and UUID of the player will show up here. It's in a list format for easy reading.

菜单

The Mage menu is for ease of access for any mage. Here, it has 5 sub-menus: Spell Menu, Wand Menu, Wand Bag, Binding Menu, and Mage Stats. Each one operates differently and allows for different things.

魔法菜单

The Spell Menu displays every spell that is loaded in the server, each spell will be blacked out until the player has learned the spell, is the right level, and has the correct permission node for it. This means the spell is fully 'unlocked'. The reason it requires all of this, is because it allows for more diversity. If an admin only wants a spell to show if they have the right node, all they have to do is turn off the other two in the settings. Once unlocked, it will show general information about a spell to help the user understand what it does and how powerful it is. You can also check out item costs here too.

法杖菜单

法杖菜单显示所有的魔法. 每个法杖都按照字母顺序排列. 只有玩家认知了某种法杖后才会解锁.

法杖袋

顾名思义,法杖袋用来存储法杖. 当玩家深入游戏后,会拥有很多不同的魔法.为了节约玩家的背包空间, 玩家可以把法杖放入法杖袋中. 法杖袋的大小和背包一样，但只能存储法杖.

绑定菜单

当绑定两个东西时绑定很复杂.
在绑定菜单中, 你也许会遇到没有魔法或法杖的情况. 可能由以下原因造成:

玩家不认识这个魔法或法杖. 玩家没有足够的等级来绑定. 玩家没有使用魔法和法杖的权限. The wand does not have the spellnode in it's compatible list.

Any of these things can preven a spell from binding with a wand. Also when binding, it's important to remember that the spellbook will be consumed! You will also have the option to bind with either Primary or Secondary. Remember if there is already a spell on either the Primary or Secondary, and you attempt to place over the spell, it will overwrite it and the current spell will be removed, with the new spell taking it's place.

魔法记录(Mage Stats)

To see what level you are, what team your on, etc. There will be more info coming soon to this, but this is basically just all your personal Mage information so you can easily see where you're at as a Mage.

权限节点

magespells.mage --允许玩家成为魔法师
magespells.admin --管理员权限

命令描述

• /mage help # 展示帮助指令
  

• /mage menu 打开magespells插件菜单
  

• /mage wandmenu 直接打开法杖菜单
  

• /mage spellmenu 直接打开魔法菜单
  
• /mage bag 直接打开法杖袋
  
• /mage stats 直接打开魔法记录菜单
  
• /mage bind 直接打开魔法绑定菜单
  
• /mage team disband 解散你的队伍
  
• /mage team create [[队伍名] [officername] 创建一个以你为队长的队伍
  
• /mage team leave 离开当前的队伍
  
• /mage team invite [玩家名] 邀请一个玩家到你的队伍
  
• /mage team accept [[队伍名] 接受一个队伍的邀请
  
• /mage team makeofficer [玩家名] 让玩家成为officer
  
• /mage team add [玩家名] [team] 添加一个玩家到队伍内
  
• /mage team remove [玩家名] [team] 把一个玩家从队伍中移除
  
• /mage spawnwand [法杖名] [玩家名] 生成特定的法杖给某玩家
  
• /mage setprimaryspell [spellname] 设置法杖左键施法
  
• /mage setsecondaryspell [spellname] 设置法杖右键施法
  
• /mage addexperience [玩家名] [amount] 给某玩家增加魔法经验
  
• /mage spawnspellbook [spellname] [玩家名] 生成特定的魔法书给某玩家
  
• /mage learnwand [法杖名] [玩家名] 给特定的玩家传授法杖用法 (解锁法杖)
  
• /mage learnspell [spellname] [玩家名] 给特定的玩家传授魔法 (解锁魔法)
  
• /mage learnall [玩家名] 传授给玩家所有的魔法和法杖
  
• /mage team kick [玩家名] 把一个踢出你的队伍 - 必须是队长才能使用
  
• /mage team promote [玩家名] 把玩家提升为officer
  
• /mage team demote [玩家名] 移除玩家的officer身份
  
• /mage team stats 展示你的队伍记录
  
• /tc [message] 在队伍内发送消息
  

权限

• magespells.mage 这个权限可以让玩家使用魔法
  

• magespells.admin 管理员权限
  

• magespells.spell.[Spellnode] 允许使用特定的魔法 (必须开启权限系统)
  

• magespells.wand.[wandnode] 允许使用特定的法杖 (必须开启权限系统)