GameRule-Extensions

作者：rndmorris

[1.7.10] Rewrites Minecraft's gamerules to be more accessible and extensible for mod authors

模组 Forge 前置库

介绍

中文介绍正在准备中，下面暂时显示原文。

GameRule-Extensions

An extension library to allow mod developers to more easily add custom gamerules, with additional datatype support.

Usage (Mod Developers Only)

Adding a new game rule

Add the API jar as a dependency to your project.
Call dev.rndmorris.gameruleexts.api.GameRulesApi.registerGameRule(...) to add a new gamerule for your mod. The api.rules package contains basic implementations for declaring boolean, numerical, and string gamerules.
If necessary, write your own IGameRule implementation.

Reading a game rule

Call dev.rndmorris.gameruleexts.api.GameRulesApi.getGameRules(...).
The returned IGameRules object can be used to retrieve and update gamerules by their name.

Examples

Creating and reading a gamerule


public class CommonProxy {
  // ...
  public void postInit(FMLPostInitializationEvent event) {
    GameRulesApi.registerGameRule(new FloatGameRule("grassCuttingSwordDamage", 90F));
  }
  // ...
}

public class SwordGrassCutting extends ItemSword {
  // ...
  public boolean hitEntity(ItemStack stack, EntityLivingBase target, EntityLivingBase player) {
    final var gameRules = GameRulesApi.getGameRules(player.worldObj);
    target.attackEntityFrom(DamageSource.causePlayerDamage(player).setMagicDamage(), gameRules.getFloat("grassCuttingSwordDamage"));
    return super.hitEntity(stack, target, player);
  }
  // ...
}

Creating a custom gamerule implementation

Here’s an example custom gamerule that maps enums to bytes.


import java.util.Arrays;
import java.util.Collection;
import java.util.List;
import java.util.stream.Collectors;

import net.minecraft.command.ICommandSender;
import net.minecraft.nbt.NBTTagCompound;

import dev.rndmorris.gameruleexts.api.IGameRule;
import dev.rndmorris.gameruleexts.api.IRuleValue;
import dev.rndmorris.gameruleexts.api.values.EnumValue;

public class ExampleCustomGameRule implements IGameRule {

    public enum ModDifficulty {

        EASY,
        MEDIUM,
        HARD;

        public static ModDifficulty fromByte(int val, ModDifficulty defaultValue) {
            return switch (val) {
                case 0 -> ModDifficulty.EASY;
                case 1 -> ModDifficulty.MEDIUM;
                case 2 -> ModDifficulty.HARD;
                default -> defaultValue;
            };
        }

        public byte toByte() {
            return switch (this) {
                case EASY -> 0;
                case MEDIUM -> 1;
                case HARD -> 2;
            };
        }
    }

    private final String name = "modDifficulty";
    private final ModDifficulty defaultValue;
    private List<String> tabCompletionValues;

    public ExampleCustomGameRule(ModDifficulty defaultValue) {
        this.defaultValue = defaultValue;
    }

    @Override
    public String getName() {
        return name;
    }

    @Override
    public IRuleValue getDefaultValue() {
        return new EnumValue<>(defaultValue, ModDifficulty.class);
    }

    @Override
    public IRuleValue readValueFromNBT(NBTTagCompound tag) {
        if (!tag.hasKey(name)) {
            return getDefaultValue();
        }
        final var value = ModDifficulty.fromByte(tag.getByte(name), defaultValue);
        return new EnumValue<>(value, ModDifficulty.class);
    }

    @Override
    public void writeValueToNBT(NBTTagCompound tag, IRuleValue value) {
        if (value instanceof EnumValue storedVal && storedVal.getValue() instanceof ModDifficulty enumVal) {
            tag.setByte(name, enumVal.toByte());
        }
    }

    @Override
    public Collection<String> tabCompletionValues(ICommandSender commandSender) {
        if (tabCompletionValues == null) {
            tabCompletionValues = Arrays.stream(ModDifficulty.values())
                    .map(ModDifficulty::toString)
                    .collect(Collectors.toList());
        }
        return tabCompletionValues;
    }
}

Credits

rndmorris (primary author)
The GTNH team, for the project template

常见问题

GameRule-Extensions 支持哪些 Minecraft 版本？

GameRule-Extensions 支持 Minecraft Java 版 1.7.10，可用的加载器：Forge。下载时注意选择和你游戏版本一致的文件。

GameRule-Extensions 怎么安装？

先用 PCL2 或 HMCL 启动器安装对应版本的 Forge，再把下载的 .jar 文件放进游戏目录的 mods 文件夹，重新启动游戏即可。开启了版本隔离的，mods 文件夹在 versions/版本名下面。运行环境：客户端 / 服务端。

登录后评论和评分

rndmorris 的其他作品

查看全部 →

Salis Arcana

by rndmorris, Midnight1458 等

A collection of config, utility, and bug fix options for Thaumcraft 4

模组 Forge 1.7.10

3.3万 2 天前 CurseForge

Essentia Pipes

by rndmorris

A hassle-free Essentia Tube alternative for Thaumcraft 4

模组 Forge 1.7.10

5,376 1 年前 Modrinth

Salis Arcana

by nicksitnikov, rndmorris 等

A collection of config, utility, and bug fix options for Thaumcraft 4

模组 Forge 1.7.10

2,784 2 天前 Modrinth

HQM Keybind

by rndmorris

Adds a keybind to open Hardcore Questing Mode's quest book without the book.

模组 Forge 1.7.10

856 2 年前 Modrinth