文章说明
下文中
- (op)表示暂时使用的参数名
- [op]表示可选操作或参数
- op1/op2表示并列的必需操作或参数
- [op1]/[op2]表示并列的可选操作或参数
指令格式
指令名：/summoningex (op)（其中op的类型为area或summon）
area
提供了对召唤区域（Summoning Area）的操作
格式：/summoningex area (op)
（其中op的类型为define，list，query，remove，show或hide）
define
用于定义和命名召唤区域
格式：/summoningex area define (x1), (y1), (z1), (x2), (y2), (x2) as #(name) [colored (colorop) (colorval) [in (dim)]]/[in (dim)]
x1, y1, z1和x2, y2, z2
定义了召唤区域的位置（以（x1, y1, z1）与（x2, y2, z2）两个方块坐标（BlockPos）为顶点）
注意x1, y1, z1, x2, y2, z2为整数且x1, x2之间，y1, y2之间与z1, z2之间没有严格的大小限制（也就是说x1既可以大于x2，又可以等于或小于x2）
x1与x2，y1与y2，z1与z2都相同时表示了一个但方块的召唤区域
name
定义了召唤区域的名称（指令中的"#"号不可省略且不能为中文）
colorop（可以传入custom或preset）及colorval
当color传入custom时，colorval应传入一个[0, 16777215]间的十进制整数，表示了召唤区域的RGB颜色值
当color传入preset时，colorval应传入原版的一种染料颜色（DyeColor），该颜色表示了召唤区域的颜色（但这个颜色的饱和度最大值被限制在了88%）
若不指定颜色则会随机为召唤区域分配一个颜色
相关代码
染料颜色的获取（getDyeColor(CommandContext
public static int getIntDyeColor(CommandContext<CommandSourceStack> context, String name) {
int textColor = getDyeColor(context, name).getTextColor();
float[] hsbvals = new float[3];
Color.RGBtoHSB(textColor >> 16 & 0xFF, textColor >> 8 & 0xFF, textColor & 0xFF, hsbvals);
// Restricts the saturation
hsbvals[1] = Math.min(0.88f, hsbvals[1]);
int color = Color.HSBtoRGB(hsbvals[0], hsbvals[1], hsbvals[2]);
// Make sure the color value is positive
color &= 0xffffff;
return color;
}颜色的随机分配
private static int randomColor(RandomSource random) {
// Randomly selects hue from 0 to 0.95 (step=0.05)
float hue = 0.05f * random.nextInt(20);
// Two types of saturation - low(0.5) and high(0.8)
float saturation = random.nextBoolean() ? 0.5f : 0.8f;
// Randomly selects hue from 0.5 to 1 (step=0.125)
float brightness = 0.5f + 0.125f * random.nextInt(5);
return Color.HSBtoRGB(hue, saturation, brightness);
}dim
定义了召唤区域所在的维度
若不指定维度则会使用当前所在维度
举例
/summoningex area define 0 100 0 10 110 10 as #Example colored custom 16777215 in minecraft:overworld
在主世界定义了一个名为Example，两个顶点分别为（0，100，0），（10，110，10）两个方块坐标，颜色为白色的召唤区域/summoningex area define 20 100 20 25 90 25 as #Example2
在指令使用者所在维度定义了一个名为Example2，两个顶点分别为（20，100，20），（25，90，25），颜色随机的召唤区域
list
用于列出指定维度内所有的召唤区域
格式：/summoningex area list [in (dim)]
dim
定义了被用来列出召唤区域的维度
若不指定维度则会使用当前所在维度
举例
/summoningex area list in minecraft:the_nether
列出了下界所有的召唤区域
query
用于在指定维度内查询指定名称的召唤区域
格式：/summoningex area query local/global (op)
（op将在下文中说明）
local与global
当使用local时，op为召唤区域名，用于在指令使用者所在维度内查询指定名称的的召唤区域
当使用global时，op为维度+召唤区域名，用于在输入的维度内查询指定名称的的召唤区域
注意使用global时不会在输入召唤区域名时提供建议（Suggestion）
举例
/summoningex area query local #Example
在指令使用者所在维度查询了名为Example的召唤区域/summoningex area query global minecraft:overworld #Example2
在主世界查询了名为Example2的召唤区域
remove
用于在指定维度内移除指定名称的召唤区域
格式：/summoningex area remove all/global/local (op)
（op将在下文中说明）
all
此时op为completely或in (dim)，也可以省略op
当op为completely时，将会移除所有维度内所有的召唤区域
当op为in (dim)时（dim为维度），将会移除指定维度内所有的召唤区域
当op省略时，将会移除指令使用者所在维度内所有的召唤区域
local与global
local与global的含义与query中大致相同，此处不再阐述
举例
/summoningex area remove local #Example
在指令使用者所在维度移除了名为Example的召唤区域/summoningex area remove all in minecraft:the_end
移除了末地所有的召唤区域
show
以长方体边框显示所有的召唤区域（召唤区域默认隐藏）
当在使用指令/summoningex area show后，如果添加了新的维度，则可能需要重新使用指令
hide
隐藏所有的召唤区域
summon
提供了在召唤区域（长方体）的底面召唤指定数量实体的操作（召唤的实体将在召唤区域的底面随机分布）
格式：/summoningex summon (entity) inside #(name) [count (cnt) [nbt (nbt)]]
entity
指定了所召唤实体的类型（同原版/summon指令的第一个参数）
name
召唤区域的名称（这里只能使用指令使用者所在维度的召唤区域）
cnt
指定了召唤实体的数量（最大为2000）
若不指定则默认召唤一个实体
nbt
指定了召唤的实体的NBT（对每个召唤的实体使用该NBT的副本）
与原版/summon指令相同，当传入NBT时，Mob类型实体的finalizeSpawn方法将不会被调用
举例
/summoningex summon minecraft:pig inside #Example count 10
在指令使用者所在维度中名为Example的召唤区域内召唤了10只猪/summoningex summon minecraft:iron_golem inside #Example2 count 5 nbt {Health:1}
在指令使用者所在维度中名为Example2的召唤区域内召唤了5个生命值为1的铁傀儡
新的实体选择器（较新的版本已移除）
本Mod提供了一个新的实体选择器（IEntitySelectorType）（默认为@b，可在配置文件内修改）
该实体选择器可以选中所有（或满足一定条件的）与指定召唤区域相交（指碰撞箱相交）的实体
格式
/@b(#(name))[op]
name
召唤区域的名称（这里只能使用指令使用者所在维度的召唤区域）
[op]
与原版实体选择器@e相同
举例
/kill @b(#Example)
杀死指令使用者所在维度中名为Example的召唤区域（下文简记为召唤区域Example）内的所有实体/effect give @b(#Example)[type=!minecraft:player] minecraft:wither 45
将45秒的凋零效果应用于召唤区域Example内所有不为玩家的实体
注意事项
- 与原版
/summon指令相同，Mod的所有指令的执行权限为2
后记
高中学习压力较大（高一的暑假就只放30多天，这个Mod是暑假抽时间做的），并且两周回家一次，因此开学后可能不会频繁地维护Mod，但我会尽量不停更，也许也会为Mod增加一些内容233
