295 lines
16 KiB
Java
295 lines
16 KiB
Java
package net.minecraft;
|
|
|
|
import com.mojang.brigadier.exceptions.CommandSyntaxException;
|
|
import io.netty.util.ResourceLeakDetector;
|
|
import io.netty.util.ResourceLeakDetector.Level;
|
|
import java.time.Duration;
|
|
import net.minecraft.commands.BrigadierExceptions;
|
|
import net.minecraft.world.level.ChunkPos;
|
|
import org.jetbrains.annotations.Nullable;
|
|
|
|
/**
|
|
* Shared global constants.
|
|
*
|
|
* <p><strong>Note:</strong> The majority of the fields within this class are {@code public static final} with constant expressions (constants), and are inlined by the Java compiler at all places which reference these constant fields. Therefore, changing the value of these constant fields will have no effect on already compiled code.</p>
|
|
*
|
|
* <p>In addition, it is presumed that a large portion of these constant fields (such as those prefixed with {@code DEBUG_} are used as 'flags', for manually toggling code meant for use by Mojang developers in debugging. Therefore, optimizing compilers (which include the Java compiler) may omit the code hidden behind disabled flags, and will result in these flags having no apparent use in the code (when in reality, the optimizing compiler has removed the code which uses them).</p>
|
|
*
|
|
* @see <a href="https://docs.oracle.com/javase/specs/jls/se16/html/jls-15.html#jls-15.29">The Java® Language Specification, Java SE 16 Edition, § 15.29. "Constant Expressions"</a>
|
|
* @see <a href="https://docs.oracle.com/javase/specs/jls/se16/html/jls-14.html#jls-14.22">The Java® Language Specification, Java SE 16 Edition, § 14.22. "Unreachable Statements"</a>
|
|
*/
|
|
public class SharedConstants {
|
|
/**
|
|
* Indicates whether the currently running game version is a snapshot version.
|
|
*
|
|
* @see com.mojang.bridge.game.GameVersion#isStable()
|
|
* @deprecated Use {@link #getCurrentVersion()} and {@link com.mojang.bridge.game.GameVersion#isStable()} instead.
|
|
*/
|
|
@Deprecated
|
|
public static final boolean SNAPSHOT = false;
|
|
/**
|
|
* The numeric format number for worlds used by this game version.
|
|
*
|
|
* @see com.mojang.bridge.game.GameVersion#getWorldVersion()
|
|
* @deprecated Use {@link #getCurrentVersion()} and {@link com.mojang.bridge.game.GameVersion#getWorldVersion()} instead.
|
|
*/
|
|
@Deprecated
|
|
public static final int WORLD_VERSION = 4325;
|
|
@Deprecated
|
|
public static final String SERIES = "main";
|
|
/**
|
|
* The human readable name of this game version.
|
|
*
|
|
* @see com.mojang.bridge.game.GameVersion#getName()
|
|
* @deprecated Use {@link #getCurrentVersion()} and {@link com.mojang.bridge.game.GameVersion#getName()} instead.
|
|
*/
|
|
@Deprecated
|
|
public static final String VERSION_STRING = "1.21.5";
|
|
/**
|
|
* The numeric format number for the networking protocol used by the release target of this game version.
|
|
*
|
|
* <p>This protocol version is used when this game version is a release version, not a {@linkplain #SNAPSHOT snapshots}. For snapshots, see {@link #SNAPSHOT_NETWORK_PROTOCOL_VERSION}.</p>
|
|
*
|
|
* @see #getProtocolVersion()
|
|
* @deprecated Use {@link #getProtocolVersion()} instead.
|
|
*/
|
|
@Deprecated
|
|
public static final int RELEASE_NETWORK_PROTOCOL_VERSION = 770;
|
|
/**
|
|
* The numeric format number for the networking protocol used by the snapshot of this game version.
|
|
*
|
|
* <p>This protocol version is used when this game version is a {@linkplain #SNAPSHOT snapshot version}. For releases, see {@link #RELEASE_NETWORK_PROTOCOL_VERSION}.</p>
|
|
*
|
|
* <p>The actual networking protocol version used in snapshot versions is the combination (bitwise OR) of this number and the bit at the position marked by {@link #SNAPSHOT_PROTOCOL_BIT}.</p>
|
|
*
|
|
* @see #getProtocolVersion()
|
|
* @deprecated Use {@link #getProtocolVersion()} instead.
|
|
*/
|
|
@Deprecated
|
|
public static final int SNAPSHOT_NETWORK_PROTOCOL_VERSION = 243;
|
|
public static final int SNBT_NAG_VERSION = 4292;
|
|
/**
|
|
* The bit in the networking protocol version for denoting {@linkplain #SNAPSHOT snapshot versions}.
|
|
*
|
|
* @see #SNAPSHOT_NETWORK_PROTOCOL_VERSION
|
|
*/
|
|
private static final int SNAPSHOT_PROTOCOL_BIT = 30;
|
|
public static final boolean CRASH_EAGERLY = false;
|
|
/**
|
|
* The format of the resource packs used by this game version. Resource packs contain client-side assets, such as translation files, models, and textures.
|
|
*
|
|
* @see com.mojang.bridge.game.GameVersion#getPackVersion(com.mojang.bridge.game.PackType)
|
|
* @deprecated Use {@link #getCurrentVersion()}, {@link com.mojang.bridge.game.GameVersion#com.mojang.bridge.game.GameVersion#getPackVersion(com.mojang.bridge.game.PackType)}, and com.mojang.bridge.game.PackType#RESOURCE instead.
|
|
*/
|
|
@Deprecated
|
|
public static final int RESOURCE_PACK_FORMAT = 55;
|
|
/**
|
|
* The format of the data packs used by this game version. Data packs contain server-side data such as recipes, loot tables, and tags.
|
|
*
|
|
* @see com.mojang.bridge.game.GameVersion#getPackVersion(com.mojang.bridge.game.PackType)
|
|
* @deprecated Use {@link #getCurrentVersion()}, {@link com.mojang.bridge.game.GameVersion#com.mojang.bridge.game.GameVersion#getPackVersion(com.mojang.bridge.game.PackType)}, and com.mojang.bridge.game.PackType#DATA instead.
|
|
*/
|
|
@Deprecated
|
|
public static final int DATA_PACK_FORMAT = 71;
|
|
@Deprecated
|
|
public static final int LANGUAGE_FORMAT = 1;
|
|
public static final int REPORT_FORMAT_VERSION = 1;
|
|
/**
|
|
* The key for the NBT tag which contains the data version of some data, for use in datafixing.
|
|
*
|
|
* <p>For various objects, their stored data in a {@link net.minecraft.nbt.CompoundTag} will usually contain a {@link net.minecraft.nbt.IntTag} indexed with this key, which stores the data version when the data for that object was written out. This is used by the datafixer system to determine which fixers needs to be applied to the data.</p>
|
|
*
|
|
* @see com.mojang.bridge.game.GameVersion#getWorldVersion()
|
|
*/
|
|
public static final String DATA_VERSION_TAG = "DataVersion";
|
|
public static final boolean FIX_TNT_DUPE = false;
|
|
public static final boolean FIX_SAND_DUPE = false;
|
|
public static final boolean USE_DEBUG_FEATURES = false;
|
|
public static final boolean DEBUG_OPEN_INCOMPATIBLE_WORLDS = false;
|
|
public static final boolean DEBUG_ALLOW_LOW_SIM_DISTANCE = false;
|
|
public static final boolean DEBUG_HOTKEYS = false;
|
|
public static final boolean DEBUG_UI_NARRATION = false;
|
|
public static final boolean DEBUG_RENDER = false;
|
|
public static final boolean DEBUG_PATHFINDING = false;
|
|
public static final boolean DEBUG_WATER = false;
|
|
public static final boolean DEBUG_HEIGHTMAP = false;
|
|
public static final boolean DEBUG_COLLISION = false;
|
|
public static final boolean DEBUG_SHOW_LOCAL_SERVER_ENTITY_HIT_BOXES = false;
|
|
public static final boolean DEBUG_SUPPORT_BLOCKS = false;
|
|
public static final boolean DEBUG_SHAPES = false;
|
|
public static final boolean DEBUG_NEIGHBORSUPDATE = false;
|
|
public static final boolean DEBUG_EXPERIMENTAL_REDSTONEWIRE_UPDATE_ORDER = false;
|
|
public static final boolean DEBUG_STRUCTURES = false;
|
|
public static final boolean DEBUG_LIGHT = false;
|
|
public static final boolean DEBUG_SKY_LIGHT_SECTIONS = false;
|
|
public static final boolean DEBUG_WORLDGENATTEMPT = false;
|
|
public static final boolean DEBUG_SOLID_FACE = false;
|
|
public static final boolean DEBUG_CHUNKS = false;
|
|
public static final boolean DEBUG_GAME_EVENT_LISTENERS = false;
|
|
public static final boolean DEBUG_DUMP_TEXTURE_ATLAS = false;
|
|
public static final boolean DEBUG_DUMP_INTERPOLATED_TEXTURE_FRAMES = false;
|
|
public static final boolean DEBUG_STRUCTURE_EDIT_MODE = false;
|
|
public static final boolean DEBUG_SAVE_STRUCTURES_AS_SNBT = false;
|
|
public static final boolean DEBUG_SYNCHRONOUS_GL_LOGS = false;
|
|
public static final boolean DEBUG_VERBOSE_SERVER_EVENTS = false;
|
|
public static final boolean DEBUG_NAMED_RUNNABLES = false;
|
|
public static final boolean DEBUG_GOAL_SELECTOR = false;
|
|
public static final boolean DEBUG_VILLAGE_SECTIONS = false;
|
|
public static final boolean DEBUG_BRAIN = false;
|
|
public static final boolean DEBUG_BEES = false;
|
|
public static final boolean DEBUG_RAIDS = false;
|
|
public static final boolean DEBUG_BLOCK_BREAK = false;
|
|
public static final boolean DEBUG_MONITOR_TICK_TIMES = false;
|
|
public static final boolean DEBUG_KEEP_JIGSAW_BLOCKS_DURING_STRUCTURE_GEN = false;
|
|
public static final boolean DEBUG_DONT_SAVE_WORLD = false;
|
|
public static final boolean DEBUG_LARGE_DRIPSTONE = false;
|
|
public static final boolean DEBUG_CARVERS = false;
|
|
public static final boolean DEBUG_ORE_VEINS = false;
|
|
public static final boolean DEBUG_SCULK_CATALYST = false;
|
|
public static final boolean DEBUG_BYPASS_REALMS_VERSION_CHECK = false;
|
|
public static final boolean DEBUG_SOCIAL_INTERACTIONS = false;
|
|
public static final boolean DEBUG_VALIDATE_RESOURCE_PATH_CASE = false;
|
|
public static final boolean DEBUG_UNLOCK_ALL_TRADES = false;
|
|
public static final boolean DEBUG_BREEZE_MOB = false;
|
|
public static final boolean DEBUG_TRIAL_SPAWNER_DETECTS_SHEEP_AS_PLAYERS = false;
|
|
public static final boolean DEBUG_VAULT_DETECTS_SHEEP_AS_PLAYERS = false;
|
|
public static final boolean DEBUG_FORCE_ONBOARDING_SCREEN = false;
|
|
public static final boolean DEBUG_CURSOR_POS = false;
|
|
public static final boolean DEBUG_IGNORE_LOCAL_MOB_CAP = false;
|
|
public static final boolean DEBUG_DISABLE_LIQUID_SPREADING = false;
|
|
public static final boolean DEBUG_AQUIFERS = false;
|
|
public static final boolean DEBUG_JFR_PROFILING_ENABLE_LEVEL_LOADING = false;
|
|
public static boolean debugGenerateSquareTerrainWithoutNoise = false;
|
|
public static boolean debugGenerateStripedTerrainWithoutNoise = false;
|
|
public static final boolean DEBUG_ONLY_GENERATE_HALF_THE_WORLD = false;
|
|
public static final boolean DEBUG_DISABLE_FLUID_GENERATION = false;
|
|
public static final boolean DEBUG_DISABLE_AQUIFERS = false;
|
|
public static final boolean DEBUG_DISABLE_SURFACE = false;
|
|
public static final boolean DEBUG_DISABLE_CARVERS = false;
|
|
public static final boolean DEBUG_DISABLE_STRUCTURES = false;
|
|
public static final boolean DEBUG_DISABLE_FEATURES = false;
|
|
public static final boolean DEBUG_DISABLE_ORE_VEINS = false;
|
|
public static final boolean DEBUG_DISABLE_BLENDING = false;
|
|
public static final boolean DEBUG_DISABLE_BELOW_ZERO_RETROGENERATION = false;
|
|
/**
|
|
* The default port used by Minecraft for communication between servers and clients.
|
|
*
|
|
* <p>This is not a registered port at the Internet Assigned Numbers Authority, and therefore may conflict with existing applications. Minecraft servers may be hosted at other ports, in which case the clients must supply the correct port when connecting to the server.</p>
|
|
*
|
|
* @see https://www.iana.org/assignments/service-names-port-numbers/service-names-port-numbers.xhtml?&page=128 Internet Assigned Numbers Authority, Internet Service Name and Transport Protocol Port Number Registry
|
|
*/
|
|
public static final int DEFAULT_MINECRAFT_PORT = 25565;
|
|
public static final boolean DEBUG_SUBTITLES = false;
|
|
public static final int FAKE_MS_LATENCY = 0;
|
|
public static final int FAKE_MS_JITTER = 0;
|
|
public static final Level NETTY_LEAK_DETECTION = Level.DISABLED;
|
|
public static final boolean COMMAND_STACK_TRACES = false;
|
|
public static final boolean DEBUG_WORLD_RECREATE = false;
|
|
public static final boolean DEBUG_SHOW_SERVER_DEBUG_VALUES = false;
|
|
public static final boolean DEBUG_FEATURE_COUNT = false;
|
|
public static final boolean DEBUG_RESOURCE_GENERATION_OVERRIDE = false;
|
|
public static final boolean DEBUG_FORCE_TELEMETRY = false;
|
|
public static final boolean DEBUG_DONT_SEND_TELEMETRY_TO_BACKEND = false;
|
|
public static final long MAXIMUM_TICK_TIME_NANOS = Duration.ofMillis(300L).toNanos();
|
|
public static final float MAXIMUM_BLOCK_EXPLOSION_RESISTANCE = 3600000.0F;
|
|
public static final boolean USE_WORKFLOWS_HOOKS = false;
|
|
public static final boolean USE_DEVONLY = false;
|
|
public static boolean CHECK_DATA_FIXER_SCHEMA = true;
|
|
public static boolean IS_RUNNING_IN_IDE;
|
|
public static final int WORLD_RESOLUTION = 16;
|
|
/**
|
|
* The maximum length of a chat message that can be typed by a player.
|
|
*/
|
|
public static final int MAX_CHAT_LENGTH = 256;
|
|
public static final int MAX_USER_INPUT_COMMAND_LENGTH = 32500;
|
|
public static final int MAX_FUNCTION_COMMAND_LENGTH = 2000000;
|
|
public static final int MAX_PLAYER_NAME_LENGTH = 16;
|
|
public static final int MAX_CHAINED_NEIGHBOR_UPDATES = 1000000;
|
|
public static final int MAX_RENDER_DISTANCE = 32;
|
|
/**
|
|
* The characters which may not form part of a file's name. Used in various file processing methods to replace these illegal characters with valid characters, such as the underscore "{@code _}".
|
|
*
|
|
* <p>This collection of characters is a subset of the forbidden characters listed in the documentation for Microsoft Windows, with the addition of the backtick ({@code `}).
|
|
*
|
|
* @see <a href="https://docs.microsoft.com/en-us/windows/win32/fileio/naming-a-file">Microsoft Corporation, "Naming Files, Paths, and Namespaces", § Naming Conventions</a>
|
|
*/
|
|
public static final char[] ILLEGAL_FILE_CHARACTERS = new char[]{'/', '\n', '\r', '\t', '\u0000', '\f', '`', '?', '*', '\\', '<', '>', '|', '"', ':'};
|
|
/**
|
|
* The amount of game ticks within a real-life second.
|
|
*
|
|
* <p>This is not guaranteed by a running server to be an accurate measurement of real-life seconds. Heavy load on the server may cause the actual tick-to-second ratio to go below this defined ratio.</p>
|
|
*/
|
|
public static final int TICKS_PER_SECOND = 20;
|
|
public static final int MILLIS_PER_TICK = 50;
|
|
/**
|
|
* The amount of game ticks within a real-life minute. This is equal to {@code TICKS_PER_SECOND * 60}, and falls under the same guarantees and restrictions as {@link #TICKS_PER_SECOND}.
|
|
*
|
|
* @see #TICKS_PER_SECOND
|
|
*/
|
|
public static final int TICKS_PER_MINUTE = 1200;
|
|
/**
|
|
* The amount of game ticks within a game day. A game day is defined as 20 real-life minutes, so this is equal to {@code TICKS_PER_MINUTE * 20}. This falls under the same guarantees and restrictions as {@link #TICKS_PER_SECOND}.
|
|
*/
|
|
public static final int TICKS_PER_GAME_DAY = 24000;
|
|
public static final float AVERAGE_GAME_TICKS_PER_RANDOM_TICK_PER_BLOCK = 1365.3334F;
|
|
public static final float AVERAGE_RANDOM_TICKS_PER_BLOCK_PER_MINUTE = 0.87890625F;
|
|
public static final float AVERAGE_RANDOM_TICKS_PER_BLOCK_PER_GAME_DAY = 17.578125F;
|
|
public static final int WORLD_ICON_SIZE = 64;
|
|
@Nullable
|
|
private static WorldVersion CURRENT_VERSION;
|
|
|
|
/**
|
|
* Sets the world version, failing if a different world version is already present.
|
|
*
|
|
* @throws IllegalStateException if a different world version has already been set previously
|
|
*
|
|
* @param version the world version to set
|
|
*/
|
|
public static void setVersion(WorldVersion version) {
|
|
if (CURRENT_VERSION == null) {
|
|
CURRENT_VERSION = version;
|
|
} else if (version != CURRENT_VERSION) {
|
|
throw new IllegalStateException("Cannot override the current game version!");
|
|
}
|
|
}
|
|
|
|
public static void tryDetectVersion() {
|
|
if (CURRENT_VERSION == null) {
|
|
CURRENT_VERSION = DetectedVersion.tryDetectVersion();
|
|
}
|
|
}
|
|
|
|
/**
|
|
* {@return the {@link WorldVersion world version}}
|
|
*
|
|
* @throws IllegalStateException if a world version has not been set previously
|
|
*/
|
|
public static WorldVersion getCurrentVersion() {
|
|
if (CURRENT_VERSION == null) {
|
|
throw new IllegalStateException("Game version not set");
|
|
} else {
|
|
return CURRENT_VERSION;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* {@return the networking protocol version in use by this game version}
|
|
*
|
|
* <p>For releases, this will be equivalent to {@link #RELEASE_NETWORK_PROTOCOL_VERSION}. For snapshot versions, this will be the combination (bitwise OR) of {@link #SNAPSHOT_NETWORK_PROTOCOL_VERSION} and the bit marked by {@link #SNAPSHOT_PROTOCOL_BIT}.</p>
|
|
*/
|
|
public static int getProtocolVersion() {
|
|
return 770;
|
|
}
|
|
|
|
public static boolean debugVoidTerrain(ChunkPos chunkPos) {
|
|
int i = chunkPos.getMinBlockX();
|
|
int j = chunkPos.getMinBlockZ();
|
|
return !debugGenerateSquareTerrainWithoutNoise ? false : i > 8192 || i < 0 || j > 1024 || j < 0;
|
|
}
|
|
|
|
static {
|
|
ResourceLeakDetector.setLevel(NETTY_LEAK_DETECTION);
|
|
CommandSyntaxException.ENABLE_COMMAND_STACK_TRACES = false;
|
|
CommandSyntaxException.BUILT_IN_EXCEPTIONS = new BrigadierExceptions();
|
|
}
|
|
}
|