最佳实践

// 使用 Option
Option<String> name = player.getName();

// 使用 Result
Result<String, Error> result = doSomething();

// 使用 Either
Either<Error, String> value = getValue();

// 不好的做法
NbtCompound tag = itemStack.tagV_2005();
tag.put("key", "value");

// 好的做法
for (NbtCompound tag : itemStack.tagV_2005().revise())
{
    tag.put("key", "value");
}

Result<ItemStack, String> result = ItemStack.decode(nbt);

for (ItemStack stack : result.getValue())
{
    // 成功
}

for (String error : result.getError())
{
    // 失败
}

Option<EntityPlayer> player = getPlayer();

for (EntityPlayer p : player)
{
    // 玩家存在
    p.sendMessage(Text.literal("Hello"));
}

// 或者
player.ifPresent(p -> p.sendMessage(Text.literal("Hello")));

@RegistrarEventListener
public class MyListener
{
    @RegistrarEventClass
    public static void onPlayerJoin(EventPlayerJoin event)
    {
        Player player = event.player;
        // 处理玩家加入
    }
}

@RegistrarEventClass(priority = Priority.HIGHEST)
public static void onEvent(MyEvent event)
{
    // 高优先级处理
}

@VersionRange(begin = 1300, end = 1400)
@WrapMinecraftMethod(@VersionName(name = "method_name"))
ReturnType method();

if (MinecraftPlatform.instance.getVersion() >= 1300)
{
    // 1.13+ 的代码
}
else
{
    // 旧版本代码
}

public static final DataKey<Player, String, ?> CUSTOM_DATA = DataKey.of("custom_data");

// 设置数据
CUSTOM_DATA.set(player, "value");

// 获取数据
Option<String> data = CUSTOM_DATA.get(player);

// 使用 NbtCompound
NbtCompound nbt = NbtCompound.newInstance();
nbt.put("key", "value");

// 翻译文本
Text text = MinecraftI18n.resolveText(player, "myplugin.message", "arg1");

// 添加翻译文件
// lang/zh_cn.json
{
    "myplugin.message": "消息: %s"
}

@Tester
public class MyTests
{
    @TesterFunction
    public void testSomething(TesterContext context)
    {
        // 测试代码
        assert condition;
    }
}