update zh loc

* add zh copy

* add Introduction but not be fully translated

* add @shadow

* Update configuration.md

* en wiki fix

* change sidebar item order

* update

* Update preface.md

* en mixinbooter format

* Update mixinbooter.md

* update

* update rong's update

* update

* update

* update

* Update event.md

* update

* update

* Update event.md

* update

* update format

* update homepage

* add grs docs to the zh environment

* grs update

* fallback to en grs wiki

* clean up

Author: TUsama

docs/.vitepress/config/zh.ts

@@ -1,22 +1,50 @@
 import { type DefaultTheme, defineConfigWithTheme } from "vitepress";
+import { generateSidebar } from "vitepress-sidebar";
 import { CleanRoomConfig } from "./customConfig";
 
+const sidebar = generateSidebar([
+  {
+    // GroovyScript:
+    documentRootPath: "docs",
+    scanStartPath: "groovy-script",
+    resolvePath: "/groovy-script/",
+    hyphenToSpace: true,
+    underscoreToSpace: true,
+    useFolderTitleFromIndexFile: true,
+    keepMarkdownSyntaxFromTitle: true,
+    useTitleFromFrontmatter: true,
+    useTitleFromFileHeading: true,
+    sortMenusByName: true,
+    collapseDepth: 2,
+    folderLinkNotIncludesFileName: true,
+    useFolderLinkFromIndexFile: true,
+  },
+]);
+
+sidebar["/zh/wiki/"] = wikiSidebar();
+
 export const zh = defineConfigWithTheme<CleanRoomConfig>({
   lang: "zh",
   description: "CleanroomMC",
   themeConfig: {
     nav: nav(),
-    sidebar: {
-      "/zh/wiki/": wikiSidebar(),
-    },
-    docFooter: {
-      next: "下一篇",
-      prev: "上一篇",
-    },
+    sidebar,
     outlineTitle: "大纲",
     lastUpdatedText: "更新于",
     editLinkText: "编辑此页",
     sourceLinkText: "查看源码",
+    timeDict: {
+      today: "今天",
+      ago: "前",
+      day: "一天",
+      days: "%d 天",
+      week: "大约一周",
+      weeks: "%d 周",
+      month: "大约一个月",
+      months: "%d 个月",
+      year: "大约一年",
+      years: "%d 年",
+    },
   },
 });
 
@@ -25,6 +53,7 @@ function nav(): DefaultTheme.NavItem[] {
     { text: "主页", link: "/zh/" },
     { text: "指南", link: "/zh/guide/" },
     { text: "维基", link: "/zh/wiki/" },
+    { text: "GroovyScript", link: "/groovy-script/" },
   ];
 }
 

docs/zh/groovy-script/content/block.md

@@ -0,0 +1,57 @@
+# Creating blocks
+
+## The simplest way
+
+```groovy:no-line-numbers
+content.createBlock(String name).register()
+```
+
+Simple right?
+Let's break it up:
+
+- `content` is a global variable.
+- `createBlock(String name)` creates a block and an item version and returns it. The name is the registry name and must only consist of lower
+  case letters and `_`.
+- `register()` registers the block and the item. Without this the block will not appear in game.
+
+## Registering a block
+
+The example above creates a simple block for you, but you can also create blocks yourself (to create custom behaviour).
+Use the following methods to register custom blocks.
+
+```groovy:no-line-numbers
+content.registerBlock(String name, Block block)
+content.registerBlock(String name, Block block, ItemBlock block)
+```
+
+## Texture
+
+Minecraft's blocks need a texture (or multiple), a model file which describes how the textures are rendered and a block state file which points each block state to a model file. If groovy
+can't find a model file or a block state file it will generate default files
+at `.minecraft/groovy/assets/[pack id]/models/block/[block name].json` and `.minecraft/groovy/assets/[pack id]/blockstates/[item name].json`.
+It will point to a texture you will need to place
+at `.minecraft/groovy/assets/[pack id]/textures/blocks/[block name].png`.
+
+## Translating the items name
+
+By default, the items name will show up as `tile.[pack id].[block name].name`. To change that you need add an entry to
+the lang file. GroovyScript generates a default lang file at `.minecraft/groovy/assets/[pack id]/lang/en_us.lang`.
+
+::: info Example {id="example"}
+
+First create a block
+
+```groovy:no-line-numbers
+content.createBlock('dust_block')
+```
+
+Let's assume that the pack id is `nomifactory` so that the item and block id will be `nomifactory:dust_block`.
+Insert this line into the lang file.
+
+```mclang:no-line-numbers
+tile.nomifactory.dust_block.name=Heart of the universe
+```
+
+(`tile.nomifactory.dust_block.name` is the default generated translation key. You can change to anything you want.) <br>
+Finally, put a texture at `.minecraft/groovy/assets/nomifactory/textures/items/dust_block.png`
+:::

docs/zh/groovy-script/content/creative_tab.md

@@ -0,0 +1,22 @@
+# Creating creative tabs
+
+```groovy:no-line-numbers
+content.createCreativeTab(String name, ItemStack icon) // returns the creative tab
+```
+
+::: info Example {id="example"}
+
+```groovy:no-line-numbers
+def creativeTab = content.createCreativeTab("nomifactory.creative_tab", item("nomifactory:heart_of_the_universe"))
+```
+:::
+
+## Other
+
+You can get a creative tab by using
+
+```groovy:no-line-numbers
+creativeTab(String tabName)
+```
+
+A list of existing creative tab names can be obtained by running the `/gs creativeTabs` command.

docs/zh/groovy-script/content/fluid.md

@@ -0,0 +1,82 @@
+# Creating fluids
+
+::: info Warning {id="warning"}
+This requires at least version 0.7.0 of GroovyScript.
+:::
+## The simplest way
+
+```groovy:no-line-numbers
+content.createFluid(String name).register()
+```
+
+Simple right?
+Let's break it up:
+
+- `content` is a global variable.
+- `createFluid(String name)` creates a fluid builder object and returns it. The name is the registry name and must only
+  consist of lower case letters and `_`.
+- `register()` registers the item. Without this the item will not appear in game.
+
+This will create a bucket item and a fluid block with a white water texture.
+
+## Setters
+
+- `setStill(ResourceLocation)` sets the still fluid texture
+- `setFlowing(ResourceLocation)` sets the flowing fluid texture
+- `setOverlay(ResourceLocation)` sets the overlay fluid texture (usually null)
+- `setTexture(ResourceLocation still, ResourceLocation flowing)` sets the still and flowing fluid texture
+- `setTexture(ResourceLocation still, ResourceLocation flowing, ResourceLocation overlay)` sets the still, flowing and overlay fluid texture
+- `setDefaultTexture()` sets the still and flowing texture to the default texture (white water)
+- `setMetalTexture()` sets the still and flowing texture to the tinkers molten metal texture
+- `setColor(int)` sets fluid color. The texture is usually white. The color is applied on top of the texture
+- `setSound(SoundEvent fillSound, SoundEvent emptySound)` sets the sounds for emptying and filling a bucket (default is from the fluids material)
+- `setLuminosity(int)` sets the luminosity. The light level of the fluid from 0 to 15 (default is 0).
+- `setDensity(int)` sets the density. Completely arbitrary value. Negative values imply that fluid is lighter than air. Default is 1000.
+- `setTemperature(int)` sets the temperature. Completely arbitrary value. Default is 300 (room temperature in Kelvin).
+- `setViscosity(int)` sets the viscosity. Completely arbitrary value Higher value makes the fluid flow slower. Default is 1000.
+- `setGaseous(boolean)` sets if the fluid is a gas. Generally this is associated with negative density fluids. Default is false.
+- `setRarity(EnumRarity)` sets the fluid rarity. This is only used for tooltip colors (afaik). Default is `EnumRarity.COMMON`.
+- `setWaterMaterial()` sets the fluid material to water. This makes the fluid blocks to behave like water. This is used by default.
+- `setLavaMaterial()` sets the fluid material to lava. This makes the fluid blocks to behave like lava. (No custom materials currently)
+- `noBlock()` disables the fluid block from generating. Buckets will not be able to place the fluid in the world.
+
+::: details Example {open id="example"}
+````groovy
+content.createFluid('molten_iron')
+    .setMetalTexture()
+    .setColor(0xFF0000)
+    .setLuminosity(4)
+    .setDensity(1700)
+    .setTemperature(1300)
+    .setViscosity(1500)
+    .setLavaMaterial()
+    .register()
+````
+:::
+
+## Registering a fluid
+
+The example above creates a simple fluid for you, but you can also create fluids yourself.
+Use the following methods to register custom fluids.
+
+```groovy:no-line-numbers
+content.registerFluid(Fluis)
+```
+
+::: info Warning {id="warning"}
+This is not recommended since using `createFluid(name).register()` does a lot of work for you.
+:::
+
+## Texture
+
+We recommend to use the default textures. But you can add other yourself.
+If a fluid has a block the block state json is automatically generated,
+
+## Translating the fluids name
+
+Add `fluid.[pack id].[fluid name]=Fluid Name` to your lang file
+
+Example for molten iron:
+```mclang:no-line-numbers
+fluid.placeholdername.molten_iron=Molten Iron
+```

docs/zh/groovy-script/content/index.md

@@ -0,0 +1,37 @@
+# Content
+
+This part of GroovyScript allows the creation of game content like items and blocks. It's equivalent to ContentTweaker
+for CraftTweaker, but for GroovyScript it doesn't require another mod.
+
+::: info Warning {id="warning"}
+Requires version 0.4.0+. <br>
+Before you start adding content make sure to specify the pack name and id in
+your [runConfig](../getting_started.md#run-config). <br>
+Also make sure to read [pack name and id](../getting_started.md#pack-name-and-id)
+:::
+
+Currently, GroovyScript adds helpers to create
+
+- [items](item.md)
+- [blocks](block.md)
+- [creative tabs](creative_tab.md)
+- [fluids](fluid.md)
+
+Coming in the future:
+
+- Mekanism gases
+
+## Creative tabs
+You can set a default creative tab which registered items and blocks will use if not specified otherwise
+```groovy:no-line-numbers
+content.setDefaultCreativeTab(CreativeTabs tab)
+```
+
+::: info Example {id="example"}
+
+With [that](creative_tab.md) we can do this
+```groovy:no-line-numbers
+def creativeTab = content.createCreativeTab("nomifactory.creative_tab", item("nomifactory:heart_of_the_universe"))
+content.setDefaultCreativeTab(creativeTab)
+```
+:::

docs/zh/groovy-script/content/item.md

@@ -0,0 +1,56 @@
+# Creating items
+
+## The simplest way
+
+```groovy:no-line-numbers
+content.createItem(String name).register()
+```
+
+Simple right?
+Let's break it up:
+
+- `content` is a global variable.
+- `createItem(String name)` creates an item and returns it. The name is the registry name and must only consist of lower
+  case letters and `_`.
+- `register()` registers the item. Without this the item will not appear in game.
+
+## Registering an item
+
+The example above creates a simple item for you, but you can also create items yourself (to create custom behaviour).
+Use the following methods to register custom items.
+
+```groovy:no-line-numbers
+content.registerItem(String name, Item item)
+```
+
+## Texture
+
+Minecraft's items need a texture (or multiple) and a model file which describes how the textures are rendered. If groovy
+can't find a model file it will generate a default file
+at `.minecraft/groovy/assets/[pack id]/models/item/[item name].json`.
+It will point to a texture you will need to place
+at `.minecraft/groovy/assets/[pack id]/textures/items/[item name].png`.
+
+## Translating the items name
+
+By default, the items name will show up as `item.[pack id].[item name].name`. To change that you need add an entry to
+the lang file. GroovyScript generates a default lang file at `.minecraft/groovy/assets/[pack id]/lang/en_us.lang`.
+
+::: info Example {id="example"}
+
+  First create an item
+
+  ```groovy:no-line-numbers
+  content.createItem('heart_of_the_universe')
+  ```
+
+  Let's assume that the pack id is `nomifactory` so that the item id will be `nomifactory:heart_of_the_universe`.
+  Insert this line into the lang file.
+
+  ```mclang:no-line-numbers
+  item.nomifactory.heart_of_the_universe.name=Heart of the universe
+  ```
+
+  (`item.nomifactory.heart_of_the_universe.name` is the default generated translation key. You can change to anything you want.) <br>
+  Finally, put a texture at `.minecraft/groovy/assets/nomifactory/textures/items/heart_of_the_universe.png`
+:::

docs/zh/groovy-script/external_compat.md

@@ -0,0 +1,45 @@
+
+# External Compat
+
+Here you'll learn about adding external mod compat for GroovyScript.
+
+::: info Warning {id="warning"}
+You need at least version 0.7.0.
+:::
+
+::: info {id="info"}
+Please read the javadoc for the interface and methods.
+:::
+
+The plugin must implement `GroovyPlugin`. GroovyScript will automatically find the class and instantiate it. If the
+instance field is non-null the class will not be instantiated by GroovyScript, but instead the value of the field will
+be used.
+
+The field `TestReg test` represents a machine that can have recipes.
+
+In `onCompatLoaded()` the compat can be initialised. `container.getVirtualizedRegistrar().addFieldsOf(this)`
+automatically register fields of this class which are `VirtualRegistries` including the `TestReg test` field.
+
+````java
+public class ExampleModGroovyPlugin implements GroovyPlugin {
+
+    public final TestReg test = new TestReg();
+
+    @Override
+    public @NotNull String getModId() {
+        return "example_id";
+    }
+
+    @Override
+    public @NotNull String getModName() {
+        return "example_name";
+    }
+
+    @Override
+    public void onCompatLoaded(GroovyContainer<?> container) {
+        GroovyScript.LOGGER.info("ExampleMod container loaded");
+        container.getVirtualizedRegistrar().addRegistry(VanillaModule.furnace);
+        container.getVirtualizedRegistrar().addFieldsOf(this);
+    }
+}
+````