# 全局的静态类 kubejs提供了以下的全局静态类和对应的方法 ## Utils | 方法 | 方法参数 | 方法作用 | 方法返回参数 | 备注 | | :------------------------------------: | :---------------------------: | :------------------------------------------: | :----------------------: | :--------------------------------------------------------------: | | toTitleCase(string) | -> | 将传入字符串第一个文本转化为大写 | 处理后的字符串 string | 除了"a", "an", "the", "of", "on", "in", "and", "or", "but" 和 "for" | | getStat(ResourceLocation) | \~ | \~ | Stat\ | 后续补充 | | snakeCaseToTitleCase(string) | -> | 将蛇形命名转换为标题大小写 | 处理后的字符串 string | 如a\_bc\_def 转为 A Bc Def | | newCountingMap() | - | 获取一个新的CountingMap | CountingMap | - | | toTitleCase(string,bool) | -> | 设置会true后将上面除了的内容也会进行大写 | 理后的字符串 string | - | | parseDouble(any,number) | -> | 将第一个参数转化为Double类型，如果失败了，则返回第二个数 | number | - | | getRandom() | - | 获取Random类 | Random | - | | newList() | - | 获取一个列表 | List\ | - | | rollChestLoot(ResourceLocation) | 战利品表id | 获取指定战利品表里的战利品数组 | List\ | - | | newRandom(number) | -> | 用一个数字当作种子生成一个Random类 | Random | - | | getRegistryIds(ResourceLocation) | -> | 获取指定注册表里的的所有id | List\ | - | | emptyList() | - | 获取一个不可变的空列表? | List\ | - | | getSystemTime() | - | 获取当前系统时间，以毫秒为单位 | number | - | | supplyAsync(Supplier\) | \~ | \~ | CompletableFuture\ | 后续补充 | | id(string,string) | -> | 将字符串转为ResourceLocation | ResourceLocation | - | | lazy(Supplier\) | \~ | \~ | Lazy\ | ? | | isWrapped(any) | -> | 判断传入对象是否为WrappedJS | boolean | - | | snakeCaseToCamelCase(string) | -> | 将蛇形命名转化为驼峰命名 | 处理后的字符串 string | 如 a\_bc\_def 转为 aBcDef | | findCreativeTab(ResourceLocation) | id | 获取该id的所在创造物品栏 | CreativeModeTab | - | | emptyMap() | - | 获取一个空的不可变的map? | Map\ | - | | expiringLazy(Supplier\,number) | \~ | \~ | Lazy\ | 后续补充 | | getSound(ResourceLocation) | id | 从id中获取SoundEvent | SoundEvent | - | | randomOf(Random,Collection\) | \~ | 使用传入的参数从列表中获取随机对象? | any | ? | | newMap() | - | 获取一个map | Map\ | - | | getRegistry(ResourceLocation) | id | 通过id获取对应的注册信息 | RegistryInfo\ | - | | particleOptions(any) | \~ | \~ | ParticleOptions | - | | copy(any) | -> | 复制一份传入的对象，如果不可以则返回本身 | any | - | | regex(string,number) | string pattern / number flags | \~ | Pattern | - | | id(string) | -> | 将字符串直接包装成ResourceLocation | ResourceLocation | - | | regex(any) | -> | \~ | Pattern | - | | runAsync(Runnable) | -> | \~ | CompletableFuture\ | - | | parseBlockState(any) | -> | 从输入内容中解析方块状态可能会抛出无效输入 | BlockState | - | | queueIO(Runnable) | -> | 立即在try-catch块中运行传递的可运行函数，并在它抛出异常时记录异常? | void | - | | parseInt(any,number) | -> | 将第一个参数转化为整数，如果失败则返回第二个参数 | number | - | | getServer() | - | 获取游戏服务端，如果是在没有服务器的地方调用则为null(startup和client) | MinecraftServer | - | | rollChestLoot(ResourceLocation,Entity) | 战利品表id，触发实体 | 用指定实体生成一个战利品表物品列表 | List\ | 不一定是箱子 | ## JsonIO | 方法 | 方法参数 | 方法作用 | 方法返回参数 | 备注 | | :-----------------------------------------: | :---: | :---------------------: | :-----------: | :--------------: | | readJson(path) | 路径字符串 | 读取指定路径的文件 | JsonElement | 文件必须为json | | toPrettyString(JsonElement) | -> | 将json转化为字符串 | string | - | | getJsonHashString(JsonElement) | -> | 获取json的hash值 | string | - | | toObject(JsonElement) | -> | 将json转化为对象??? | any | 后续测试 | | primitiveOf(any) | ? | ? | JsonPrimitive | 后续测试 | | readString(path) | 路径 | 读取指定路径的文件 | string | 读取为string格式 | | writeJsonHash(DataOutputStream,JsonElement) | ? | \~ | void | 后续测试 | | parseRaw(string) | ? | ? | JsonElement | 后续测试 | | write(path,JsonObject) | -> | 将json对象写入到指定路径的文件里 | void | 一定要是json对象，不能是数组 | | read(path) | -> | 读取指定路径的文件 | Map\ | 建议使用readJson | | toArray(JsonElement) | -> | 将JsonElement转为JsonArray | JsonArray | - | | parse(string) | -> | ? | any | 后续测试 | | toPrimitive(JsonElement) | -> | ? | any | 后续测试 | | copy(JsonElement) | -> | 复制一份JsonElement | JsonElement | - | | toString(JsonElement) | -> | 将json转为字符串 | string | - | | getJsonHashBytes(JsonElement) | -> | 将json转为hashByte | number\[] | - | | of(any) | ? | ? | JsonElement | - | ## BlockPos | 方法 | 方法参数 | 方法作用 | 方法返回参数 | 备注 | | :----------------------------------------------------------------------------------------------------: | :------------------------: | :---------------------------: | :---------------------------------: | :-: | | asLong(number,number,number) | 依次顺序为X,Y,Z坐标 | 通过坐标获取对应的数值 | number | - | | betweenClosed(n1,n2,n3,n4,n5,n6) | 依次顺序为x1,y1,z1,x2,y2,z2 | 通过两个坐标获取该区域内的所有坐标 | Iterable\ | - | | betweenClosedStream(BlockPos,BlockPos) | - | 同上 | Stream\ | - | | breadthFirstTraversal(BlockPos,number,BiConsumer\>,Predicate\) | 坐标，最大距离，-，回调用于处理每个遍历到的方块位置 | 按广度优先的顺序遍历周围的方块 | number | - | | containing(Position) | -> | 根据Position返回BlockPos | BlockPos | - | | findClosestMatch(BlockPos,number,number,Predicate\) | \~ | \~ | Optional\ | - | | getFlatIndex(number) | \~ | \~ | number | - | | getX(number) | -> | 获取对应值 | number | - | | getY(number) | -> | 获取对应值 | number | - | | getZ(number) | -> | 获取对应值 | number | - | | of(number) | 坐标数值（asLong获取的这种数字数值 | - | BlockPos | - | | offset(number,number,number) | \~ | \~ | number | - | | offset(number,Direction) | \~ | \~ | number | - | | offsetCodec(number) | \~ | \~ | Codec\ | - | | randomBetweenClosed(RandomSource,n1,n2,n3,n4,n5,n6) | -> | 在一个区域内随机生成坐标 | Iterable\ | - | | randomInCube(RandomSource,number,BlockPos,number) | ? | 通过一个坐标中心点向外延申到指定距离的方块区域内生成坐标? | Iterable\ | - | | spiralAround(BlockPos,number,Direction,Direction) | \~ | 按照螺旋式路径遍历周围的方块位置 | Iterable\ | - | | withinManhattan(BlockPos,number,number,number) | -> | 获取在曼哈顿距离范围内的所有坐标 | Iterable\ | - | | withinManhattanStream(BlockPos,number,number,number) | -> | 同上 | Stream\ | - | ## Block ## Vec3d ## KMath | 方法 | 方法参数 | 方法作用 | 方法返回参数 | 备注 | | :-------------------------: | :-------------------------: | :-----------------------: | :------------------: | :------------------------------: | | block(n1,n2,n3) | -> | 根据xyz返回blockPos | BlockPos | - | | deg(number) | ? | ? | number | - | | v3d(n1,n2,n3) | -> | 根据xyz返回Vector3d | Vector3d | - | | ceil(number) | ? | ? | number | - | | map(n1,n2,n3,n4,n5) | value,min1,max1,min2,max2 | ? | number | ? | | clamp(n1,n2.n3) | value,min,max | ? | number | ? | | v4f(n1,n2,n3,n4) | -> | 根据xyz和w（猜测是宽度）返回Vec4f | Vec4f | - | | rad(number) | ? | ? | number | - | | degreesDifference(n1,n2) | current,target | \~ | number | 待测试 | | floor(number) | -> | 向下取整 | number | - | | poseStack() | - | -> | PoseStack | - | | lerp(n1,n2,n3) | value,min,max | 线性插值，通过修改value的比例，返回特定的数值 | number | 举个栗子value=0.5,min=0,max=10,则会返回5 | | clampedLerp(n1,n2,n3) | 同上 | 同上但是不会超值max的值 | number | 同上但是不会超出max | | v3f(n1,n2,n3) | -> | 通过xyz返回Vec3f | Vec3f | - | | rotateIfNecessary(n1,n2,n3) | current,target,max | \~ | number | - | | m4f() | - | \` | Matrix4f | - | | v3(n1,n2,n3) | -> | 通过xyz获取Vec3d | Vec3d | - | | quaternion(n1,n2,n3,n4) | 根据xyz和w（猜测是宽度）返回Quaternionf | Quaternionf | - | | | wrapDegrees(number) | -> | 处理角度 | number | - | | m3f() | - | - | Matrix3f | - | | approachDegrees(n1,n2,n3) | current,target,speed | \~ | number | - | | approach(n1,n2,n3) | current,target,speed | \~ | number | - | | isPowerOfTwo(number) | -> | 判断是否为 2 的幂次方 | bool | - | | PI | - | - | 3.141592653589793 | - | | RADIANS\_TO\_DEGREES | - | - | 57.29577951308232 | - | | DEGREES\_TO\_RADIANS | - | - | 0.017453292519943295 | - | | E | - | - | 2.718281828459045 | - | ## RotationAxis ## ResourceLocation ## Items ## SoundType | 类型常量 | 对应方块/物品类型 | | :-------------------------: | :--------: | | EMPTY | 空类型（无声音） | | SAND | 沙子 | | DECORATED\_POT | 装饰性陶罐 | | TUFF | 凝灰岩 | | GRAVEL | gravel | | SHROOMLIGHT | 菌光体 | | MOSS | 苔藓 | | SOUL\_SOIL | 灵魂土 | | WEEPING\_VINES | 垂泪藤 | | ANCIENT\_DEBRIS | 远古残骸 | | SCULK\_SENSOR | 幽匿感测体 | | POINTED\_DRIPSTONE | 滴水石锥 | | ROOTED\_DIRT | 植根泥土 | | FROGSPAWN | 青蛙卵 | | NETHER\_ORE | 下界矿石 | | COPPER | 铜 | | LANTERN | 灯笼 | | BONE\_BLOCK | 骨块 | | FROGLIGHT | 蛙明灯 | | SNOW | 雪 | | SCULK\_VEIN | 幽匿脉络 | | CHERRY\_WOOD | 樱花木 | | POLISHED\_DEEPSLATE | 抛光深板岩 | | NYLIUM | 菌岩 | | DEEPSLATE | 深板岩 | | SPORE\_BLOSSOM | 孢子花 | | BASALT | 玄武岩 | | CHERRY\_WOOD\_HANGING\_SIGN | 樱花木悬挂牌 | | SMALL\_AMETHYST\_BUD | 小型紫水晶芽 | | CANDLE | 蜡烛 | | FLOWERING\_AZALEA | 开花杜鹃 | | ANVIL | 铁砧 | | SCAFFOLDING | 脚手架 | | DEEPSLATE\_BRICKS | 深板岩砖 | | CORAL\_BLOCK | 珊瑚块 | | BAMBOO\_SAPLING | 竹子幼苗 | | LILY\_PAD | 睡莲 | | MOSS\_CARPET | 苔藓地毯 | | LADDER | 梯子 | | LARGE\_AMETHYST\_BUD | 大型紫水晶芽 | | GLOW\_LICHEN | 发光地衣 | | CROP | 农作物 | | PINK\_PETALS | 粉色花瓣 | | AZALEA\_LEAVES | 杜鹃树叶 | | POWDER\_SNOW | 细雪 | | METAL | 金属 | | HONEY\_BLOCK | 蜂蜜块 | | NETHER\_BRICKS | 下界砖块 | | SUSPICIOUS\_SAND | 可疑的沙子 | | GILDED\_BLACKSTONE | 镶金黑石 | | HARD\_CROP | 坚硬农作物 | | SCULK\_CATALYST | 幽匿催化体 | | DEEPSLATE\_TILES | 深板岩瓦 | | PACKED\_MUD | 压实泥土 | | SCULK | 幽匿块 | | VINE | 藤蔓 | | BAMBOO | 竹子 | | GLASS | 玻璃 | | DRIPSTONE\_BLOCK | 滴水石块 | | CHERRY\_SAPLING | 樱花树苗 | | CALCITE | 方解石 | | MUD\_BRICKS | 泥砖 | | STEM | 茎（如蘑菇茎） | | BAMBOO\_WOOD | 竹材 | | SOUL\_SAND | 灵魂沙 | | MUD | 泥土 | | BIG\_DRIPLEAF | 大型滴水叶 | | BAMBOO\_WOOD\_HANGING\_SIGN | 竹材悬挂牌 | | TWISTING\_VINES | 扭曲藤 | | NETHERRACK | 下界岩 | | AMETHYST\_CLUSTER | 紫水晶簇 | | SLIME\_BLOCK | 史莱姆块 | | SCULK\_SHRIEKER | 幽匿尖啸体 | | CHAIN | 链条 | | WOOD | 木材 | | AZALEA | 杜鹃花 | | MANGROVE\_ROOTS | 红树根 | | CHISELED\_BOOKSHELF | 雕花书架 | | NETHER\_GOLD\_ORE | 下界金矿 | | CHERRY\_LEAVES | 樱花树叶 | | AMETHYST | 紫水晶 | | DECORATED\_POT\_CRACKED | 破损的装饰性陶罐 | | CAVE\_VINES | 洞穴藤 | | SUSPICIOUS\_GRAVEL | 可疑的 gravel | | LODESTONE | 磁石 | | FUNGUS | 真菌 | | SMALL\_DRIPLEAF | 小型滴水叶 | | HANGING\_ROOTS | 悬挂的根 | | SWEET\_BERRY\_BUSH | 甜浆果丛 | | NETHER\_WOOD | 下界木材 | | NETHER\_WART | 下界 wart | | STONE | 石头 | | NETHER\_WOOD\_HANGING\_SIGN | 下界木材悬挂牌 | | HANGING\_SIGN | 悬挂牌 | | WET\_GRASS | 湿润的草 | | NETHERITE\_BLOCK | Netherite块 | | MEDIUM\_AMETHYST\_BUD | 中型紫水晶芽 | | MUDDY\_MANGROVE\_ROOTS | 泥泞的红树根 | | WOOL | 羊毛 | | ROOTS | 根部 | | WART\_BLOCK | Wart块 | | NETHER\_SPROUTS | 下界苗 | ## Stats 使用方法简单示例1： `Utils.server.getPlayer("gu__meng").getStats().get(Stats.BLOCK_MINED.get(Block.getBlock("stone")))` 使用方法简单示例2： `Utils.server.getPlayer("gu__meng").getStats().get(Stats.SWIM_ONE_CM)` | 状态常量 | 描述 | 备注 | | :--------------------------------: | :------------: | :---------: | | SWIM\_ONE\_CM | 游泳的总距离 | - | | FLY\_ONE\_CM | 飞行的总距离 | - | | WALK\_ONE\_CM | 步行的总距离 | - | | CLIMB\_ONE\_CM | 攀爬的总距离 | - | | FALL\_ONE\_CM | 下落的总距离 | - | | BOAT\_ONE\_CM | 乘船的总距离 | - | | STRIDER\_ONE\_CM | 骑炽足兽的总距离 | - | | HORSE\_ONE\_CM | 骑马的总距离 | - | | PIG\_ONE\_CM | 骑猪的总距离 | - | | MINECART\_ONE\_CM | 乘坐矿车的总距离 | - | | WALK\_ON\_WATER\_ONE\_CM | 在水上行走的总距离 | - | | WALK\_UNDER\_WATER\_ONE\_CM | 在水下行走的总距离 | - | | SPRINT\_ONE\_CM | 奔跑的总距离 | - | | CROUCH\_ONE\_CM | 蹲下移动的总距离 | - | | AVIATE\_ONE\_CM | 滑翔（如用鞘翅）的总距离 | - | | PLAYER\_KILLS | 杀死玩家的数量 | - | | MOB\_KILLS | 杀死生物的数量 | - | | DEATHS | 死亡次数 | - | | DAMAGE\_DEALT | 造成的总伤害 | - | | DAMAGE\_DEALT\_RESISTED | 对有抗性的目标造成的伤害 | - | | DAMAGE\_DEALT\_ABSORBED | 被目标吸收的伤害 | - | | DAMAGE\_TAKEN | 受到的总伤害 | - | | DAMAGE\_RESISTED | 抵抗的伤害（如通过盔甲） | - | | DAMAGE\_ABSORBED | 吸收的伤害（如通过吸收效果） | - | | DAMAGE\_BLOCKED\_BY\_SHIELD | 用盾牌格挡的伤害 | - | | ENTITY\_KILLED | 杀死的实体类型 | 需要get(实体类型) | | ENTITY\_KILLED\_BY | 被哪些实体杀死 | 需要get(实体类型) | | ITEM\_PICKED\_UP | 捡起的物品 | 需要get(物品) | | ITEM\_DROPPED | 丢弃的物品 | 需要get(物品) | | ITEM\_USED | 使用的物品 | 需要get(物品) | | ITEM\_BROKEN | 损坏的物品 | 需要get(物品) | | ITEM\_CRAFTED | 合成的物品 | 需要get(物品) | | BLOCK\_MINED | 挖掘的方块 | 需要get(方块) | | POT\_FLOWER | 种植的花数量 | - | | EAT\_CAKE\_SLICE | 吃掉的蛋糕片数量 | - | | OPEN\_CHEST | 打开箱子的次数 | - | | OPEN\_ENDERCHEST | 打开末影箱的次数 | - | | OPEN\_SHULKER\_BOX | 打开潜影盒的次数 | - | | OPEN\_BARREL | 打开木桶的次数 | - | | TRIGGER\_TRAPPED\_CHEST | 触发陷阱箱的次数 | - | | INSPECT\_DISPENSER | 查看发射器的次数 | - | | INSPECT\_DROPPER | 查看投掷器的次数 | - | | INSPECT\_HOPPER | 查看漏斗的次数 | - | | INTERACT\_WITH\_CRAFTING\_TABLE | 使用工作台的次数 | - | | INTERACT\_WITH\_FURNACE | 使用熔炉的次数 | - | | INTERACT\_WITH\_BLAST\_FURNACE | 使用高炉的次数 | - | | INTERACT\_WITH\_SMOKER | 使用烟熏炉的次数 | - | | INTERACT\_WITH\_BREWINGSTAND | 使用酿造台的次数 | - | | INTERACT\_WITH\_ANVIL | 使用铁砧的次数 | - | | INTERACT\_WITH\_GRINDSTONE | 使用砂轮的次数 | - | | INTERACT\_WITH\_STONECUTTER | 使用切石机的次数 | - | | INTERACT\_WITH\_LOOM | 使用织布机的次数 | - | | INTERACT\_WITH\_CARTOGRAPHY\_TABLE | 使用制图台的次数 | - | | INTERACT\_WITH\_SMITHING\_TABLE | 使用锻造台的次数 | - | | INTERACT\_WITH\_LECTERN | 使用讲台的次数 | - | | INTERACT\_WITH\_BEACON | 使用信标的次数 | - | | ENCHANT\_ITEM | 附魔物品的次数 | - | | TOTAL\_WORLD\_TIME | 游戏世界总时间 | - | | PLAY\_TIME | 玩家游戏时长 | - | | TIME\_SINCE\_REST | 上次睡觉至今的时间 | - | | TIME\_SINCE\_DEATH | 上次死亡至今的时间 | - | | LEAVE\_GAME | 退出游戏的次数 | - | | SLEEP\_IN\_BED | 在床上睡觉的次数 | - | | JUMP | 跳跃次数 | - | | CROUCH\_TIME | 蹲下的总时间 | - | | BELL\_RING | 敲响铃铛的次数 | - | | INTERACT\_WITH\_CAMPFIRE | 与营火交互的次数 | - | | FISH\_CAUGHT | 钓到鱼的数量 | - | | USE\_CAULDRON | 使用炼药锅的次数 | - | | FILL\_CAULDRON | 装满炼药锅的次数 | - | | PLAY\_NOTEBLOCK | 播放音符盒的次数 | - | | TUNE\_NOTEBLOCK | 调谐音符盒的次数 | - | | PLAY\_RECORD | 播放唱片的次数 | - | | TARGET\_HIT | 击中目标的次数 | - | | CLEAN\_SHULKER\_BOX | 清理潜影盒的次数 | - | | CLEAN\_ARMOR | 清理盔甲的次数 | - | | CLEAN\_BANNER | 清理旗帜的次数 | - | | DROP | 丢弃物品的总次数 | - | ## Duration ## OutputItem ## Fluid ## InputItem ## DamageSource ## Platform ## Vec3f ## Vec4f ## Notification ## Quaternionf ## JavaMath ## BlockProperties ## Vec3i ## Matrix3f ## Matrix4f ## Blocks ## Component --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://gumeng.gitbook.io/ce-shi/kubejsadvanced/staticclsss.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.