` in HTML | [Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| stack_panel | Similar to `panel` but stacks its children depending on `orientation` property value | [Stack Panel](/json-ui/json-ui-documentation#stack-panel)
[Collection](/json-ui/json-ui-documentation#collection)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| collection_panel | Similar to `stack_panel`, but does not have the `orientation` property | [Collection](/json-ui/json-ui-documentation#collection)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| grid | Grid of elements | [Grid](/json-ui/json-ui-documentation#grid)
[Collection](/json-ui/json-ui-documentation#collection)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| label | Text element | [Text](/json-ui/json-ui-documentation#text)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| image | Sprite element. Draws a texture. | [Sprite](/json-ui/json-ui-documentation#sprite)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| input_panel | A `panel` that accepts input | [Input](/json-ui/json-ui-documentation#input)
[Focus](/json-ui/json-ui-documentation#focus)
[Sound](/json-ui/json-ui-documentation#sound)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| button | A button and it can have 4 states (default, hover, pressed and locked) | [Button](/json-ui/json-ui-documentation#button)
[Input](/json-ui/json-ui-documentation#input)
[Focus](/json-ui/json-ui-documentation#focus)
[Sound](/json-ui/json-ui-documentation#sound)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| toggle | A toggle and it has 2 states (checked or unchecked). Each state has a hover and locked variant | [Toggle](/json-ui/json-ui-documentation#toggle)
[Input](/json-ui/json-ui-documentation#input)
[Focus](/json-ui/json-ui-documentation#focus)
[Sound](/json-ui/json-ui-documentation#sound)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| dropdown | A toggle for dropdown purposes | [Dropdown](/json-ui/json-ui-documentation#dropdown)
[Toggle](/json-ui/json-ui-documentation#toggle)
[Input](/json-ui/json-ui-documentation#input)
[Focus](/json-ui/json-ui-documentation#focus)
[Sound](/json-ui/json-ui-documentation#sound)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| slider | Range input element | [Slider](/json-ui/json-ui-documentation#slider)
[Input](/json-ui/json-ui-documentation#input)
[Focus](/json-ui/json-ui-documentation#focus)
[Sound](/json-ui/json-ui-documentation#sound)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| slider_box | The slider button that you use to change the slider value | [Slider Box](/json-ui/json-ui-documentation#slider-box)
[Input](/json-ui/json-ui-documentation#input)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| edit_box | Text field element. By default it's single-lined | [Text Edit](/json-ui/json-ui-documentation#text-edit)
[Button](/json-ui/json-ui-documentation#button)
[Input](/json-ui/json-ui-documentation#input)
[Focus](/json-ui/json-ui-documentation#focus)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| scroll_view | Creates a scrolling panel element | [Scroll View](/json-ui/json-ui-documentation#scroll-view)
[Input](/json-ui/json-ui-documentation#input)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| scrollbar_track | The scrollbar track | [Input](/json-ui/json-ui-documentation#input)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout) |
+| scrollbar_box | The scrollbar "thumb"/button. The draggable scrolling handle. By default is oriented vertically | [Input](/json-ui/json-ui-documentation#input)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout) |
+| factory | A element generator | [Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout) |
+| screen | Screen element | [Screen](/json-ui/json-ui-documentation#screen) [Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| custom | Special renderer element that is created in the code because it's too complex for JSON UI | [Custom Render](/json-ui/json-ui-documentation#custom-render)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| selection_wheel | | [Selection Wheel](/json-ui/json-ui-documentation#selection-wheel)
[Input](/json-ui/json-ui-documentation#input)
[Focus](/json-ui/json-ui-documentation#focus)
[Sound](/json-ui/json-ui-documentation#sound)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+
+#### Legacy Element Types (No longer work)
+
+| Name | Description | Allowed Properties |
+| -------------- | -------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| tab | The way tabs were made before the addition of toggles | [Tab](/json-ui/json-ui-documentation#tab-legacy)
[Button](/json-ui/json-ui-documentation#button)
[Input](/json-ui/json-ui-documentation#input)
[Focus](/json-ui/json-ui-documentation#focus)
[Sound](/json-ui/json-ui-documentation#sound)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| carousel_label | | [Carousel Text](/json-ui/json-ui-documentation#carousel-text-legacy)
[Text](/json-ui/json-ui-documentation#text)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| grid_item | A `panel` but specifically to be an item/child of a grid | [Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+| scrollbar | | [Input](/json-ui/json-ui-documentation#input)
[Focus](/json-ui/json-ui-documentation#focus)
[Control](/json-ui/json-ui-documentation#control)
[Layout](/json-ui/json-ui-documentation#layout)
[Data Binding](/json-ui/json-ui-documentation#data-binding) |
+
+## Properties
+
+### Control
+
+| Property Name | Type | Default Value | Description |
+| ------------------------- | :------------------: | :-----------: | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| visible | boolean | `true` | If the UI element should be visible |
+| enabled | boolean | `true` | If true and if the UI element or any of its children have the locked state then they will be in the locked |
+| layer | int | `0` | Z-Index/Layer (like zindex in CSS) relative to parent element. Higher layers will render above |
+| alpha | float | `1.0` | Alpha/transparency of the element. It will only affect the UI element. Its children will be unaffected. If you want the alpha to apply for both the parent and children also use `propagate_alpha` |
+| propagate_alpha | boolean | `false` | If `alpha` should not only apply to the parent if possible but also all its children |
+| clips_children | boolean | `false` | Cuts off visually and interactively everything beyond the bounderies of the UI element |
+| allow_clipping | boolean | `true` | If `clips_children` works in the UI element. Otherwise, it won't have any effect |
+| clip_offset | Vector [x, y] | `[0, 0]` | Offset from the start of the clipping |
+| clip_state_change_event | string | | |
+| enable_scissor_test | boolean | | [https://www.khronos.org/opengl/wiki/Scissor_Test](https://www.khronos.org/opengl/wiki/Scissor_Test) |
+| property_bag | object | | [Property bag](/json-ui/json-ui-documentation#property-bag) contains properties/variables that are more related with the data than the actually structure and look of the UI element |
+| selected | boolean | | If the text box is selected by default |
+| use_child_anchors | boolean | `false` | Use the `anchor_from` and`anchor_to` of the child of the UI element |
+| controls | array | | For adding children to the element |
+| anims | string[] | | Array of the animation names |
+| disable_anim_fast_forward | boolean | | |
+| animation_reset_name | string | | |
+| ignored | boolean | `false` | If the UI element should be ignored |
+| variables | array or object | | A bunch of conditions that change the variables values |
+| modifications | array | | Allows to modify the UI files of resource packs below (vanilla being the most bottom one) |
+| grid_position | Vector [row, column] | | Position that the control will take inside the grid. This also allows to modify specific grid items of a hardcoded grid |
+| collection_index | int | | Index that the control takes in the collection |
+
+#### Legacy (no longer works)
+
+| Property Name | Type | Default Value | Description |
+| ------------- | :------: | :-----------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| z_order | int | 0 | First version of the `layer` property |
+| scroll_report | string[] | | Array of the name of the controls to notify when content inside of the scroll panel changes |
+| alignment | enum | | Possible values:
`top_left`
`top_middle`
`top_right`
`left_middle`
`center`
`right_middle`
`bottom_left`
`bottom_middle`
`bottom_right` |
+
+### Layout
+
+| Property Name | Type | Default Value | Description |
+| -------------------------- | :--------------------: | :----------------------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| size | Vector [width, height] | `["default", "default"]` | Size of the UI element.
Possible values:
`"default"` (Default value which is `"100%"`)
`0` (Number of pixels)
`"0px"` (Number of pixels. It's the same as 0 but it's put inside a string with px at the end. It's used when you want to sum or subtract a percentage based value with a specific number of pixels. (e.g. `"75% + 12px"`))
`"0%"` (Percentage of relative to the parent element)
`"0%c"` (Percentage of the total width/height of the element children)
`"0%cm"` (Percentage of the width/height of the biggest visible child of that element)
`"0%sm"` (Percentage of the width/height of the sibling element)
`"0%y"` (Percentage of the element height)
`"0%x"` (Percentage of the element width)
`"fill"` (Expands to the remaining width/height of the parent element) |
+| max_size | Vector [width, height] | `["default", "default"]` | Maximum size of the UI element can have |
+| min_size | Vector [width, height] | `["default", "default"]` | Minimum size of the UI element can have |
+| offset | Vector [x, y] | `[0, 0]` | Position of the UI element relative to the parent UI element. It's TopLeft based meaning the coordinates [0, 0] start at the top left of the screen.
`10`- pixels
`"10px"` - pixels
`"50%"` - Width/height of the parent element
`"50%x"` - Width of the element
`"50%y"` - Height of the element |
+| anchor_from | enum | `center` | Anchor point in the parent element.
Possible values:
`top_left`
`top_middle`
`top_right`
`left_middle`
`center`
`right_middle`
`bottom_left`
`bottom_middle`
`bottom_right` |
+| anchor_to | enum | `center` | Anchor point in the element.
Possible values:
`top_left`
`top_middle`
`top_right`
`left_middle`
`center`
`right_middle`
`bottom_left`
`bottom_middle`
`bottom_right` |
+| inherit_max_sibling_width | boolean | `false` | Use the maximum width of the sibling element |
+| inherit_max_sibling_height | boolean | `false` | Use the maximum height of the sibling element |
+| use_anchored_offset | boolean | | |
+| contained | boolean | | |
+| draggable | enum | | Makes the element draggable through cursor. The element should be able to accept input in order to be draggable (`input_panel`, `button`, etc.) and must have the required button mappings.
Possible values: `vertical`, `horizontal` and `both` |
+| follows_cursor | boolean | `false` | Follows the cursor |
+
+### Data Binding
+
+| Property Name | Type | Default Value | Description |
+| ------------- | :---------------------------------------------------------------------------------------: | :-----------: | -------------------------------------------------- |
+| bindings | Vector of [binding object](/json-ui/json-ui-documentation#data-binding-array-object) | | Bind and work with hardcoded values in the element |
+
+
+#### Data Binding Array Object
+
+Data Binding allows to bind hardcoded values/variables to an element property.
+
+| Property Name | Type | Default Value | Description |
+| ------------------------- | :-----: | :-----------: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| ignored | boolean | `false` | If binding should be ignored |
+| binding_type | enum | | Possible values:
`global`
`view`
`collection`
`collection_details`
`none` |
+| binding_name | string | | Stores the value of the data binding name or condition with it |
+| binding_name_override | string | | Name of the UI element property that will apply the stored value in `binding_name` |
+| binding_collection_name | string | | Name of the collection of items to be used |
+| binding_collection_prefix | string | | |
+| binding_condition | enum | | Condition for the data binding to happen.
Possible values:
`always`
`always_when_visible`
`visible`
`once`
`none`
`visibility_changed` |
+| source_control_name | string | | Name of the UI element to observe its property values |
+| source_property_name | string | | Store the value of the property value of the UI element refered in `source_control_name` |
+| target_property_name | string | | The UI element property that the stored value in `source_property_name` will be applied to |
+| resolve_sibling_scope | boolean | | If `true`, allows the selection of a sibling element in the same control instead of its child, for `source_control_name` |
+
+### Stack Panel
+
+| Property Name | Type | Default Value | Description |
+| ------------- | :---: | :-----------: | ---------------------------------------------------------------------------------------------------------- |
+| orientation | enum | `vertical` | Direction the elements stack inside `stack_panel`.
Possible values:
`vertical`
`horizontal` |
+
+### Grid
+
+| Property Name | Type | Default Value | Description |
+| ------------------------- | :--------------------: | ------------- | ----------------------------------------------------------------------------------------------------------------------------------- |
+| grid_dimensions | Vector [rows, columns] | | Number of columns and rows the grid has |
+| maximum_grid_items | int | | Maximum number of items the grid will generate |
+| grid_dimension_binding | string | | Binding name for grid dimensions |
+| grid_rescaling_type | enum | | Grid rescaling orientation.
Possible values:
`vertical`
`horizontal`
`none` |
+| grid_fill_direction | enum | | Possible values:
`vertical`
`horizontal`
`none` |
+| grid_item_template | string | | An element capable of handling collections
(e.g. `"common.container_item"`, `"container_items"`, `"inventory_items"` and etc.) |
+| precached_grid_item_count | int | | |
+
+### Text
+
+| Property Name | Type | Default Value | Description |
+| ----------------------- | :--------------: | :---------------: | --------------------------------------------------------------------------------------------------------------------- |
+| text | string | | Text content |
+| color | Vector [r, g, b] | `[1.0, 1.0, 1.0]` | Text color. RGB value from 0.0 to 1.0 |
+| locked_color | Vector [r, g, b] | | Text color when a parent has `enabled: false` |
+| shadow | boolean | `false` | Text shadow |
+| hide_hyphen | boolean | `false` | Hide hyphen caused by word breaking |
+| notify_on_ellipses | string[] | | Array of names of the controls to notify when text gets or loses ellipses |
+| enable_profanity_filter | boolean | `false` | If "bad" words should be censored |
+| locked_alpha | float | | Alpha/transparency of label when a parent has `enabled: false` |
+| font_size | enum | `normal` | Size of the text.
Possible values:
`small`
`normal`
`large`
`extra_large` |
+| font_scale_factor | float | `1.0` | Scale of the text |
+| localize | boolean | `false` | If ```text``` should be able to be translated |
+| line_padding | number | | Space between lines |
+| font_type | enum | `default` | Font of the text.
Possible values:
`default`
`rune`
`unicode`
`smooth`
`MinecraftTen`
or any other custom font |
+| backup_font_type | enum | `default` | Font used if `font_type` didn't work |
+| text_alignment | enum | | Text alignment direction. If it's not defined it will adjust automatically based on `anchor_from` and ```anchor_to``` |
+
+#### Legacy (no longer works)
+
+| Property Name | Type | Default Value | Description |
+| ------------- | :-----: | :-----------: | ------------------------------------------------------------------- |
+| wrap | boolean | `false` | Break text into lines if text is bigger than width of the element |
+| clip | boolean | `false` | |
+
+
+
+Use of `notify_on_ellipses`. Mostly used with hardcoded texts.
+
+
RP/ui/example_file.json
+
+```json
+{
+ "label": {
+ ...
+ "notify_on_ellipses": [
+ "my_button"
+ ]
+ },
+
+ "my_button": {
+ ...
+ "bindings": [
+ {
+ "binding_type": "view",
+ "source_property_name": "#using_ellipses",
+ "target_property_name": "#visible"
+ }
+ ]
+ }
+}
+```
+
+### Sprite
+
+| Property Name | Type | Default Value | Description |
+| --------------------------- | :-------------------------------------------: | :-----------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| texture | string | | Image path starting from pack root. (e.g. `"textures/ui/White"`) |
+| allow_debug_missing_texture | boolean | `true` | Display the missing_texture if the texture is not found |
+| uv | Vector [u, v] | | Start position of the texture mapping |
+| uv_size | Vector [width, height] | | Size of the texture mapping |
+| texture_file_system | string |`InUserPackage`| Source to get the texture.
Possible values:
`InUserPackage`
`InAppPackage`
`RawPath`
`RawPersistent`
`InSettingsDir`
`InExternalDir`
`InServerPackage`
`InDataDir`
`InUserDir`
`InWorldDir`
`StoreCache`
Usage is Unknown |
+| nineslice_size | int, Vector [x, y] or Vector [x0, y0, x1, y1] | | 9-slice. A method that divides an texture into 9 pieces. When resized the corners will stay in place and the rest will stretch |
+| tiled | boolean or enum | | If the texture will tile when the size of the UI element is bigger than the texture size.
Possible values:
`true`/`false`
`x`
`y` |
+| tiled_scale | Vector [sX, sY] | `false` | Scale of the tile textures |
+| clip_direction | enum | | Start point position for the `clip_ratio`. If `down`, the image will begin to appear from the bottom.
Possible values:
`left`
`right`
`up`
`down`
`center` |
+| clip_ratio | float | | How much to clip. From 0.0 to 1.0 |
+| clip_pixelperfect | boolean | | If the clip should try to be the most pixel accurate possible |
+| keep_ratio | boolean | `true` | Keep ratio when resizing image |
+| bilinear | boolean | `false` | Use the bilinear function when resizing the image |
+| fill | boolean | `false` | Scratch the image to the size |
+| $fit_to_width | boolean | | |
+| zip_folder | string | | |
+| grayscale | boolean | `false` | Render image in black and white |
+| force_texture_reload | boolean | | Reload image when the texture path is changed |
+| base_size | Vector [width, height] | | |
+
+To use clipping, bind a `#*_ratio` binding name to a `#clip-ratio` property with binding condition `"always"`. Progress arrow and fuel images in furnace UI work like this.
+
+### Input
+
+| Property Name | Type | Default Value | Description |
+| ---------------------------------- | :-----------------------------------------------------------------------------------------: | :-----------: | ----------- |
+| button_mappings | Vector of [mapping object](/json-ui/json-ui-documentation#button-mapping-array-object) | | |
+| modal | boolean | | |
+| inline_modal | boolean | | |
+| always_listen_to_input | boolean | | |
+| always_handle_pointer | boolean | | |
+| always_handle_controller_direction | boolean | | |
+| hover_enabled | boolean | | |
+| prevent_touch_input | boolean | | |
+| consume_event | boolean | | |
+| consume_hover_events | boolean | | |
+| gesture_tracking_button | string | | |
+
+#### Button Mapping Array Object
+
+| Property Name | Type | Default Value | Description |
+| -------------------------------- | :-----: | :-----------: | ---------------------------------------------------------------------------------- |
+| ignored | boolean | `false` | If mapping should be ignored |
+| from_button_id | string | | ID of the action that fires the event |
+| to_button_id | string | | ID of the action to be executed when event is fired |
+| mapping_type | enum | | Possible values:
`global`
`pressed`
`double_pressed`
`focused` |
+| scope | enum | | Possible values:
`view`
`controller` |
+| input_mode_condition | enum | | Possible values:
`not_gaze`
`not_gamepad`
`gamepad_and_not_gaze` |
+| ignore_input_scope | boolean | | |
+| consume_event | boolean | | |
+| handle_select | boolean | | |
+| handle_deselect | boolean | | |
+| button_up_right_of_first_refusal | boolean | | |
+
+### Focus
+
+| Property Name | Type | Default Value | Description |
+| ---------------------------- | :-----------------------------------------------------------------------------------------------------------: | :-----------: | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| default_focus_precedence | int | | |
+| focus_enabled | boolean | | If the arrow keys or controller can focus the element |
+| focus_wrap_enabled | boolean | | |
+| focus_magnet_enabled | boolean | | |
+| focus_identifier | string | | Focus identifier for this element |
+| focus_change_down | string | | Identifier (`focus_identifier`) of the focusable element that will recieve focus when on button.menu_down. If you want to prevent the focus to escape from the bottom use `FOCUS_OVERRIDE_STOP` |
+| focus_change_up | string | | Identifier (`focus_identifier`) of the focusable element that will recieve focus when on button.menu_up. If you want to prevent the focus to escape from the top use `FOCUS_OVERRIDE_STOP` |
+| focus_change_left | string | | Identifier (`focus_identifier`) of the focusable element that will recieve focus when on button.menu_left. If you want to prevent the focus to escape from the left use `FOCUS_OVERRIDE_STOP` |
+| focus_change_right | string | | Identifier (`focus_identifier`) of the focusable element that will recieve focus when on button.menu_right. If you want to prevent the focus to escape from the right use `FOCUS_OVERRIDE_STOP` |
+| focus_mapping | array | | |
+| focus_container | boolean | | |
+| use_last_focus | boolean | | |
+| focus_navigation_mode_left | enum | | Possible values: `none`
`stop`
`custom`
`contained` |
+| focus_navigation_mode_right | enum | | Possible values: `none`
`stop`
`custom`
`contained` |
+| focus_navigation_mode_down | enum | | Possible values: `none`
`stop`
`custom`
`contained` |
+| focus_navigation_mode_up | enum | | Possible values: `none`
`stop`
`custom`
`contained` |
+| focus_container_custom_left | Vector of [focus container custom object](/json-ui/json-ui-documentation#focus-container-custom-array-object) | | |
+| focus_container_custom_right | Vector of [focus container custom object](/json-ui/json-ui-documentation#focus-container-custom-array-object) | | |
+| focus_container_custom_down | Vector of [focus container custom object](/json-ui/json-ui-documentation#focus-container-custom-array-object) | | |
+| focus_container_custom_up | Vector of [focus container custom object](/json-ui/json-ui-documentation#focus-container-custom-array-object) | | |
+
+
+#### Focus Container Custom Array Object
+
+| Property Name | Type | Description |
+| -------------------------- | :----: | ------------------------------------------------------------------------------------------------------------------------------ |
+| other_focus_container_name | string | Name of the UI control that will receive focus when on button.menu_left, button.menu_right, button.menu_up or button.menu_down |
+| focus_id_inside | string | Identifier (`focus_identifier`) of the focusable child control of the `other_focus_container_name` that will recieve the focus |
+
+
RP/ui/example_file.json
+
+```json
+...
+{
+ "other_panel": {
+ ...
+ "focus_container": true,
+ "controls": [
+ ...
+ ]
+ }
+},
+{
+ "input_panel": {
+ ...
+ "focus_container_custom_up": [
+ {
+ "other_focus_container_name": "other_panel" // name of the object that will receive focus when the focus of this container ends on `button.menu_up`
+ }
+ ]
+ }
+}
+...
+```
+
+### Button
+
+| Property Name | Type | Default Value | Description |
+| --------------- | :----: | :-----------: | -------------------------------------------------------------------------- |
+| default_control | string | | Name of the child control that will be displayed only in the default state |
+| hover_control | string | | Name of the child control that will be displayed only in the hover state |
+| pressed_control | string | | Name of the child control that will be displayed only in the pressed state |
+| locked_control | string | | Name of the child control that will be displayed only in the locked state |
+
+### Toggle
+
+| Property Name | Type | Default Value | Description |
+| ------------------------------ | :-----: | :-----------: | ----------------------------------------------------------------------------------------- |
+| radio_toggle_group | boolean | | |
+| toggle_name | string | | Identifier for the toggle group it belongs to. It can be a custom one. |
+| toggle_default_state | boolean | | |
+| toggle_group_forced_index | int | | Index of the toggle in its group |
+| toggle_group_default_selected | int | | Index of the default toggle of the its group |
+| reset_on_focus_lost | boolean | | |
+| toggle_on_hover | string | | |
+| toggle_on_button | string | | |
+| toggle_off_button | string | | |
+| enable_directional_toggling | boolean | | |
+| toggle_grid_collection_name | string | | Name of the collection the toggle belongs to |
+| checked_control | string | | Name of the child control that will be displayed only in the checked state |
+| unchecked_control | string | | Name of the child control that will be displayed only in the unchecked state |
+| checked_hover_control | string | | Name of the child control that will be displayed only in the checked hover state |
+| unchecked_hover_control | string | | Name of the child control that will be displayed only in the unchecked hover state |
+| checked_locked_control | string | | Name of the child control that will be displayed only in the checked locked state |
+| unchecked_locked_control | string | | Name of the child control that will be displayed only in the unchecked locked state |
+| checked_locked_hover_control | string | | Name of the child control that will be displayed only in the checked locked hover state |
+| unchecked_locked_hover_control | string | | Name of the child control that will be displayed only in the unchecked locked hover state |
+### HardCoded Toggles
+
+In some screens,navigation tab group has its mapping default selected tabs,such as settings or inventory.
+I guess these values are right.
+```json
+$search_index - $construction_index
+$survival_layout_index - $construction_index
+$recipe_book_layout_index - $equipment_index
+$creative_layout_index - $items_index
+``````
+And there are some must toggles in setting and inventory,even though you can not get a warning without dev version and open the assert diagnosis,they exactly esist and controlled by a function called *ScreenView::_passViewCommand::
::()::::operator()*,when you totally modify these screens,you may meet this assertion.
+
+For example,in setting that is accessibility and in inventory,the construction,equipment,items and nature tabs are must.
+### Dropdown
+
+| Property Name | Type | Default Value | Description |
+| ------------------------ | :----: | :-----------: | -------------------------------------------------------------------- |
+| dropdown_name | string | | Identifier for the dropdown |
+| dropdown_content_control | string | | Name of the child control that will behave as the root content panel |
+| dropdown_area | string | | Name of the child control that will behave as the inside content |
+
+### Sound
+
+| Property Name | Type | Description |
+| ------------- | :------------------------------------------------------------------------------: | ------------------------------------------------------------------------------------------------------------------- |
+| sound_name | string | Name of the sound defined in the `RP/sounds/sound_definitions.json` file that plays when the pressed event is fired |
+| sound_volume | float | Volume of the sound |
+| sound_pitch | float | Pitch of the sound |
+| sounds | Vector of [sound object](/json-ui/json-ui-documentation#sound-array-object) | Array of the sounds to play when the pressed event is fired |
+
+#### Sound Array Object
+
+| Property Name | Type | Description |
+| ------------------------- | :----: | ------------------------------------------------------------------------------------------------------------------- |
+| sound_name | string | Name of the sound defined in the `RP/sounds/sound_definitions.json` file that plays when the pressed event is fired |
+| sound_volume | float | Volume of the sound |
+| sound_pitch | float | Pitch of the sound |
+| min_seconds_between_plays | float | Seconds of wait before the sound can be played again |
+
+
+### Collection
+
+| Property Name | Type | Description |
+| --------------- | :----: | --------------------------------- |
+| collection_name | string | Name of the collection to be used |
+
+### Text Edit
+
+| Property Name | Type | Default Value | Description |
+| ---------------------------------- | :-----: | :-----------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| text_box_name | string | | Identifier for text box |
+| text_edit_box_grid_collection_name | string | | Name of the collection the `edit_box` belongs to |
+| constrain_to_rect | boolean | | |
+| enabled_newline | boolean | | Allows multiline text |
+| text_type | enum | | Type of characters that the user is allowed to type in th text field.
Possible values:
`ExtendedASCII`
`IdentifierChars`
`NumberChars` |
+| max_length | int | | Maximum number of characters allow in the text field |
+| text_control | string | | Name of the child control that will be used for displaying the text |
+| place_holder_control | string | | Name of the child control that will be used for display the placeholder text |
+| can_be_deselected | boolean | | |
+| always_listening | boolean | | |
+| virtual_keyboard_buffer_control | string | | |
+
+### Slider
+
+| Property Name | Type | Default Value | Description |
+| ---------------------------- | :-----: | :-----------: | ------------------------------------------------------------------------------------------------------------ |
+| slider_track_button | string | | ID of the action for the slider track |
+| slider_small_decrease_button | string | | ID of the action for the decrease slider |
+| slider_small_increase_button | string | | ID of the action for the increase slider |
+| slider_steps | int | | nHow many steps (or values) does the slider have |
+| slider_direction | enum | | Orientation of the slider movement.
Possible values:
`vertical`
`horizontal` |
+| slider_timeout | number | | |
+| slider_collection_name | string | | Name of the collection the slider belongs to |
+| slider_name | string | | Identifier for the slider |
+| slider_select_on_hover | boolean | | Focus slider when it's hovered |
+| slider_selected_button | string | | ID of the action for when the slider is selected |
+| slider_deselected_button | string | | ID of the action for when the slider is deselected |
+| slider_box_control | string | | Name of the child control that will behave as the slider thumb |
+| background_control | string | | Name of the child control that will behave as the slider background |
+| background_hover_control | string | | Name of the child control that will behave as the slider background on hover |
+| progress_control | string | | Name of the child control that will behave as the slider background overlay for the slider progress |
+| progress_hover_control | string | | Name of the child control that will behave as the slider background overlay for the slider progress on hover |
+
+### Slider Box
+
+| Property Name | Type | Default Value | Description |
+| --------------- | :----: | :-----------: | --------------------------------------------------------------------- |
+| default_control | string | | Name of the child control that will be displayed in the default state |
+| hover_control | string | | Name of the child control that will be displayed in the hover state |
+| locked_control | string | | Name of the child control that will be displayed in the locked state |
+
+### Scroll View
+
+| Property Name | Type | Default Value | Description |
+| -------------------------- | :-----: | :-----------: | ------------------------------------------------------------------------------------------------- |
+| scrollbar_track_button | string | | ID of the action for the track button |
+| scrollbar_touch_button | string | | ID of the action for the touch input |
+| scroll_speed | number | | Scrolling speed |
+| gesture_control_enabled | boolean | | |
+| always_handle_scrolling | boolean | | |
+| touch_mode | boolean | | |
+| scrollbar_box | string | | Name of child UI element or nested UI element that will behave as the scrollbar thumb. |
+| scrollbar_track | string | | Name of child UI element or nested UI element that will behave as the scrollbar track |
+| scroll_view_port | string | | Name of child UI element that will behave as the view port |
+| scroll_content | string | | Name of child UI element that will behave as the content root parent |
+| scroll_box_and_track_panel | string | | Name of child UI element that will contain the scrollbox and track controls |
+| jump_to_bottom_on_update | boolean | | Jump to the bottom when the scrolling panel has an update. For example, adds more children to it. |
+
+### Custom Render
+
+| Property Name | Type | Description |
+| ------------- | :---: | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
+| renderer | enum | Possible values:
`hover_text_renderer`
`3d_structure_renderer`
`splash_text_renderer`
`ui_holo_cursor`
`trial_time_renderer`
`panorama_renderer`
`actor_portrait_renderer`
`banner_pattern_renderer`
`live_player_renderer`
`web_view_renderer`
`hunger_renderer`
`bubbles_renderer`
`mob_effects_renderer`
`cursor_renderer`
`progress_indicator_renderer`
`camera_renderer`
`horse_jump_renderer`
`armor_renderer`
`horse_heart_renderer`
`heart_renderer`
`hotbar_cooldown_renderer`
`hotbar_renderer`
`hud_player_renderer`
`live_horse_renderer`
`holographic_postrenderer`
`enchanting_book_renderer`
`debug_screen_renderer`
`gradient_renderer`
`paper_doll_renderer`
`name_tag_renderer`
`flying_item_renderer`
`inventory_item_renderer`
`credits_renderer`
`vignette_renderer`
`progress_bar_renderer`
`debug_overlay_renderer`
`background_renderer`
`bohr_model_renderer`
`experience_renderer` (Legacy, no longer works)
`menu_background_renderer` (Legacy, no longer works) |
+
+
+#### Renderers
+
+| Renderer Name | Description |
+| ----------------------------- | -------------------------------------------------------------------------------------------------------------- |
+| `flying_item_renderer` | The flying item when you change an item from a slot to another |
+| `inventory_item_renderer` | Renders an item icon. It only work in screens when ingame |
+| `credits_renderer` | The credits and end poem |
+| `vignette_renderer` | A vignette |
+| `name_tag_renderer` | It's something like the playername above the player head or the name above animals when used a nametag on them |
+| `paper_doll_renderer` | A skin model |
+| `debug_screen_renderer` | The debug text that appears on the beta/preview versions |
+| `enchanting_book_renderer` | The enchantment table book. It opens when there's an item to be enchanted |
+| `gradient_renderer` | Draws a gradient |
+| `live_horse_renderer` | The horse/donkey/llama... model |
+| `live_player_renderer` | The player model |
+| `hud_player_renderer` | The player model that imitates what the player is doing |
+| `hotbar_renderer` | Gets the hotbar slot image for each slot |
+| `hotbar_cooldown_renderer` | Draws the item cooldown |
+| `heart_renderer` | Draws the player health |
+| `horse_heart_renderer` | Draws the horse/donkey/... health |
+| `armor_renderer` | Draws the player armor |
+| `horse_jump_renderer` | Draws the horse jumping progress bar |
+| `hunger_renderer` | Draws the player hunger |
+| `bubbles_renderer` | Draws the respiration bubbles |
+| `mob_effects_renderer` | Draws the effects that are applied to the player |
+| `cursor_renderer` | Draws the crosshair in the center of the screen |
+| `progress_indicator_renderer` | Not used |
+| `camera_renderer` | Used for the camera item |
+| `web_view_renderer` | Shows a website view |
+| `banner_pattern_renderer` | Renders a banner |
+| `actor_portrait_renderer` | Draws an portrait |
+| `trial_time_renderer` | In the trial version of the game it renders the time left to be able to use the world |
+| `progress_bar_renderer` | Draws a progress bar. It has more than one type |
+| `3d_structure_renderer` | Renders the structure block structure |
+| `splash_text_renderer` | Gets and renders a random splash text from the `splashes.json` file |
+| `hover_text_renderer` | Draws a tooltip |
+| `ui_holo_cursor` | |
+| `panorama_renderer` | It's not the panoramas that appear behind the menus. It's the panorama of the worlds on the store. |
+
+
+#### Specific Properties
+
+| Property Name | Type | Renderer | Description |
+| -------------------- | :-----------------: | --------------------------------------------- | ------------------------------------------------------------- |
+| gradient_direction | enum | `gradient_renderer` | Possible values:
`vertical`
`horizontal` |
+| color1 | Vector [r, g, b, a] | `gradient_renderer` | |
+| color2 | Vector [r, g, b, a] | `gradient_renderer` | |
+| text_color | Vector [r, g, b, a] | `name_tag_renderer` | |
+| background_color | Vector [r, g, b, a] | `name_tag_renderer` | |
+| primary_color | Vector [r, g, b, a] | `progress_bar_renderer` | |
+| secondary_color | Vector [r, g, b, a] | `progress_bar_renderer` | |
+| camera_tilt_degrees | number | `paper_doll_renderer` | |
+| starting_rotation | number | `paper_doll_renderer` | |
+| use_selected_skin | boolean | `paper_doll_renderer` | |
+| use_uuid | boolean | `paper_doll_renderer` | |
+| use_skin_gui_scale | boolean | `paper_doll_renderer` | |
+| use_player_paperdoll | boolean | `paper_doll_renderer` | |
+| rotation | enum | `paper_doll_renderer` and `panorama_renderer` | Possible values:
`auto`
`gesture_x`
`custom_y` |
+| end_event | string | `credits_renderer` | |
+
+### Screen
+
+| Property Name | Type | Description |
+| ----------------------------------- | :-----: | ------------------------------------------------------------------------- |
+| render_only_when_topmost | boolean | Only render the screen if it's the most top screen in the screen stack |
+| screen_not_flushable | boolean | |
+| always_accepts_input | boolean | |
+| render_game_behind | boolean | Doesn't prevent screen below of being able to receive input from the user |
+| absorbs_input | boolean | |
+| is_showing_menu | boolean | |
+| is_modal | boolean | It's a screen modal |
+| should_steal_mouse | boolean | Captures the cursor and hides it |
+| low_frequency_rendering | boolean | Uses less memory to render the screen |
+| screen_draws_last | boolean | It's the last screen to be drawn/rendered |
+| vr_mode | boolean | |
+| force_render_below | boolean | Renders bottom screens below current screen in the screen stack |
+| send_telemetry | boolean | |
+| close_on_player_hurt | boolean | Close the screen is the player takes damage |
+| cache_screen | boolean | |
+| load_screen_immediately | boolean | |
+| gamepad_cursor | boolean | |
+| gamepad_cursor_deflection_mode | boolean | |
+| should_be_skipped_during_automation | boolean | |
+
+### Selection Wheel
+
+| Property Name | Type | Description |
+| ------------------------- | :------: | ----------- |
+| inner_radius | number | |
+| outer_radius | number | |
+| state_controls | string[] | |
+| slice_count | integer | |
+| button_name | string | |
+| iterate_left_button_name | string | |
+| iterate_right_button_name | string | |
+| initial_button_slice | integer | |
+
+### TTS
+| Property Name | Type | Description |
+| ----------------------------------- | :-----: | ------------------------------------------------------------------------------------------ |
+| tts_name | string | |
+| tts_control_header | string | |
+| tts_section_header | string | |
+| tts_control_type_order_priority | integer | |
+| tts_index_priority | integer | |
+| tts_toggle_on | string | Use by the `toggle` type |
+| tts_toggle_off | string | Use by the `toggle` type |
+| tts_override_control_value | string | |
+| tts_inherit_siblings | boolean | |
+| tts_value_changed | string | |
+| ttsSectionContainer | boolean | |
+| tts_ignore_count | boolean | |
+| tts_skip_message | boolean | |
+| tts_value_order_priority | integer | |
+| tts_play_on_unchanged_focus_control | boolean | |
+| tts_ignore_subsections | boolean | |
+| text_tts | string | |
+| use_priority | boolean | If the `priority` property will be use to determine the TTS priority of each child control |
+| priority | boolean | Order/index of priority that the element has on TTS |
+
+### Tab (Legacy)
+
+| Property Name | Type | Default Value | Description |
+| ------------- | :----: | :-----------: | --------------------------------------------------------- |
+| tab_index | int | | ID of tab in its group |
+| tab_group | int | | ID of the group the tab belongs to |
+| tab_control | string | | Name of the control that will show when the tab is active |
+
+### Carousel Text (Legacy)
+
+| Property Name | Type | Default Value | Description |
+| ------------- | :------------------: | :-----------: | ------------------------------- |
+| always_rotate | boolean | | |
+| rotate_speed | number | | |
+| hover_color | Vector [r, g, b, a], | | `color` when element is hovered |
+| hover_alpha | float | | `alpha` when element is hovered |
+| pressed_color | Vector [r, g, b, a], | | `color` when element is pressed |
+| pressed_alpha | float | | `alpha` when element is pressed |
+
+## Properties Additional Information
+
+### Anchor Properties
+
+Anchors allows the elements to align to a certain point where position, size, scale, animations, etc will take as the point for transformation.
+In JSON UI, there's two properties `anchor_from` and `anchor_to` that together achieve this.
+
+Most people use them by giving them the same value:
+
+RP/ui/example_file.json
+
+```json
+{
+ "element": {
+ "anchor_from": "top_left",
+ "anchor_to": "top_left"
+ }
+}
+```
+
+
+
+However, what happens when they have different values? Let's look at happens when `anchor_from: center` and `anchor_from: top_left`. It's the best example to demonstrate what's really happening.
+
+RP/ui/example_file.json
+
+```json
+{
+ "element": {
+ "anchor_from": "center",
+ "anchor_to": "top_left"
+ }
+}
+```
+
+
+
+The top left point of the element is in the center point of the parent element.
+
+Another example:
+
+
+
+The blue box top left point is in the top middle point of the parent element. As for the black box, the right midde point is in the center of the parent.
+
+
+Basically `anchor_to` is the anchor point in the element that will be attached to the `anchor_from` in the parent element.
+
+### Variables Property
+
+| Name | Type | Description |
+| ---------- | :----: | ----------- |
+| `requires` | string | condition |
+
+
+
+If you only have one variable to use, you should just use `"variables": {}`
+
+RP/ui/example_file.json
+
+```json
+{
+ "element": {
+ ...
+ "size": "$el_size",
+ "$el_size|default": ["100%", 20],
+ "variables": {
+ "requires": "$var_condition",
+ "$el_size": ["100%", 30]
+ }
+ }
+}
+```
+
+If you have multiple variables use `"variables": [{}]`
+
+RP/ui/example_file.json
+
+```json
+{
+ "element": {
+ ...
+ "size": "$el_size",
+ "offset": "$el_offset",
+ "$el_offset|default": [0, 40],
+ "$el_size|default": ["100%", 20],
+ "variables": [
+ {
+ "requires": "$var_condition",
+ "$el_size": ["100%", 30]
+ },
+ {
+ "requires": "$other_var_condition",
+ "$el_offset": [0, 15],
+ "$el_size": ["90%", 35]
+ }
+ ]
+ }
+}
+```
+
+## Property Bag
+
+| Name | Type | Requirements | Description |
+| ---------------------------------- | :-----------------: | ---------------------------------------------------- | --------------------------------------------------------------- |
+| #filtered_light_multiplier | float | type[custom]
renderer[inventory_item_renderer] | |
+| #banner_patterns | string | type[custom]
renderer[inventory_item_renderer] | |
+| #banner_colors | string | type[custom]
renderer[inventory_item_renderer] | |
+| #item_id_aux | int | type[custom]
renderer[inventory_item_renderer] | |
+| #item_custom_color | int | type[custom]
renderer[inventory_item_renderer] | |
+| #disabled_filter_visible | boolean | type[custom]
renderer[inventory_item_renderer] | |
+| #item_pickup_time | float | type[custom]
renderer[inventory_item_renderer] | |
+| #look_at_cursor | boolean | type[custom]
renderer[hud_player_renderer] | |
+| entity_type | enum | type[custom]
renderer[paper_doll_renderer] | Possible values:
`player`
`npc` |
+| #skin_idx | int | type[custom]
renderer[paper_doll_renderer] | |
+| #player_uuid | string | type[custom]
renderer[paper_doll_renderer] | |
+| #skin_rotation | boolean | type[custom]
renderer[paper_doll_renderer] | |
+| #custom_rot_y | float | type[custom]
renderer[paper_doll_renderer] | |
+| #gesture_delta_source | string | type[custom]
renderer[paper_doll_renderer] | |
+| #gesture_mouse_delta_x | string | type[custom]
renderer[paper_doll_renderer] | |
+| #pack_id | int | type[custom]
renderer[paper_doll_renderer] | |
+| #force_skin_update | string | type[custom]
renderer[paper_doll_renderer] | |
+| #progress_bar_visible | boolean | type[custom]
renderer[paper_doll_renderer] | |
+| #progress_bar_total_amount | float | type[custom]
renderer[progress_bar_renderer] | |
+| #progress_bar_current_amount | float | type[custom]
renderer[progress_bar_renderer] | |
+| is_durability | boolean | type[custom]
renderer[progress_bar_renderer] | |
+| round_value | boolean | type[custom]
renderer[progress_bar_renderer] | |
+| #hover_text | string | type[custom]
renderer[hover_text_renderer] | |
+| #open | boolean | type[custom]
renderer[enchanting_book_renderer] | |
+| flying_item_count | int | type[custom]
renderer[flying_item_renderer] | |
+| flying_item_id_aux | int | type[custom]
renderer[flying_item_renderer] | |
+| flying_item_custom_color | int | type[custom]
renderer[flying_item_renderer] | |
+| flying_item_origin_position_x | float | type[custom]
renderer[flying_item_renderer] | |
+| flying_item_origin_position_y | float | type[custom]
renderer[flying_item_renderer] | |
+| flying_item_origin_scale | float | type[custom]
renderer[flying_item_renderer] | |
+| flying_item_destination_position_x | float | type[custom]
renderer[flying_item_renderer] | |
+| flying_item_destination_position_y | float | type[custom]
renderer[flying_item_renderer] | |
+| flying_item_destination_scale | float | type[custom]
renderer[flying_item_renderer] | |
+| flying_item_banner_patterns | string | type[custom]
renderer[flying_item_renderer] | |
+| flying_item_banner_colors | string | type[custom]
renderer[flying_item_renderer] | |
+| #use_heart_offset | boolean | type[custom]
renderer[armor_renderer] | |
+| opacity_override | float | type[custom]
renderer[vignette_renderer] | |
+| #playername | string | type[custom]
renderer[name_tag_renderer] | |
+| #x_padding | number | type[custom]
renderer[name_tag_renderer] | |
+| #entity_id | string or int | type[custom]
renderer[live_horse_renderer] | |
+| #hyperlink | string | type[button] | |
+| #anchored_offset_value_x | number | `use_anchored_offset` property | |
+| #anchored_offset_value_y | number | `use_anchored_offset` property | |
+| #size_binding_x | number | `use_anchored_offset` property | |
+| #size_binding_y | number | `use_anchored_offset` property | |
+| #has_focus | boolean | type[custom]
renderer[3d_structure_renderer] | |
+| #block_position | Vector [x, y, z] | type[custom]
renderer[3d_structure_renderer] | |
+| #top_right_block | Vector [x, y, z] | type[custom]
renderer[3d_structure_renderer] | |
+| #bottom_left_block | Vector [x, y, z] | type[custom]
renderer[3d_structure_renderer] | |
+| #include_entities | boolean | type[custom]
renderer[3d_structure_renderer] | |
+| #remove_blocks | boolean | type[custom]
renderer[3d_structure_renderer] | |
+| #include_players | boolean | type[custom]
renderer[3d_structure_renderer] | |
+| #slider_steps | number | type[slider] | |
+| #slider_value | number | type[slider] | |
+| #property_field | string | type[edit_box] | |
+| #hover_slice | int | type[selection_wheel] | |
+| #toggle_state | boolean | type[toggle] | |
+| #start_selected | boolean | | |
+| #tts_dialog_title | string | | |
+| #tts_dialog_body | string | | |
+| force_update | boolean | | |
+| #sub_command | string | | |
+| #panel_title | string | | |
+| #index | int | | |
+| #collection_prefix | string | | |
+| #collection_name | string | | |
+| #visible | boolean | | |
+| #common | Vector [r, g, b, a] | | |
+| #uncommon | Vector [r, g, b, a] | | |
+| #rare | Vector [r, g, b, a] | | |
+| #epic | Vector [r, g, b, a] | | |
+| #legendary | Vector [r, g, b, a] | | |
+| reset_group | enum | | Possible values:
`video`
`audio`
`accessibility` |
+| #text | string | | |
+| timer_duration | number | | |
+| #should_host | boolean | | |
+| is_local | boolean | | |
+| #is_left | boolean | | |
+| #is_skins | boolean | | |
+| #is_featured | boolean | | |
+| #image_name | string | | |
+| #is_dropdown | boolean | | |
+| #timer_field_count_to_show | number | | |
+| #owned_incompatible_prompt_color | Vector [r, g, b] | | |
+| #modal_title_text | string | | |
+| #modal_label_text | string | | |
+| #buttons_visible | boolean | | |
+| #no_buttons_visible | boolean | | |
+| #single_button_visible | boolean | | |
+| #two_buttons_visible | boolean | | |
+| is_fixed_inventory | boolean | | |
+| experimental_radio_button_state | string | | |
+| classic_radio_button_state | string | | |
+
+## Animations
+
+| Animation Property Name | Type | Description |
+| ------------------------- | :-----------: | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| anim_type | enum | Possible values:
`alpha`
`clip`
`color`
`flip_book`
`offset`
`size`
`uv`
`wait`
`aseprite_flip_book` |
+| duration | number | |
+| next | string | |
+| destroy_at_end | string | |
+| play_event | string | |
+| end_event | string | |
+| start_event | string | |
+| reset_event | string | |
+| easing | enum | Possible values:
`linear`
`spring`
`in_quad`
`out_quad`
`in_out_quad`
`in_cubic`
`out_cubic`
`in_out_cubic`
`in_quart`
`out_quart`
`in_out_quart`
`in_quint`
`out_quint`
`in_out_quint`
`in_sine`
`out_sine`
`in_out_sine`
`in_expo`
`out_expo`
`in_out_expo`
`in_circ`
`out_circ`
`in_out_circ`
`in_bounce`
`out_bounce`
`in_out_bounce`
`in_back`
`out_back`
`in_out_back`
`in_elastic`
`out_elastic`
`in_out_elastic` |
+| from | | |
+| to | | |
+| initial_uv | Vector [u, v] | |
+| fps | int | Frames per second |
+| frame_count | int | |
+| frame_step | number | |
+| reversible | boolean | |
+| resettable | boolean | |
+| scale_from_starting_alpha | boolean | |
+| activated | boolean | |
+
+For more information about the `aseprite_flip_book` animation type, please see our page on [Aseprite Animations](/json-ui/aseprite-animations)
+
+## Global Variables
+
+| Variable | Note |
+| -------------------------------------- | ----------------------------------------------------------------------------------------- |
+| $store_disabled | |
+| $game_pad | There's a controller connected to the device |
+| $mouse | There's a mouse connected to the device |
+| $touch | |
+| $trial | It's in the trial version of the game |
+| $build_platform_UWP | |
+| $win10_edition | |
+| $ignore_add_servers | |
+| $disable_gamertag_controls | |
+| $console_edition | |
+| $osx_edition | |
+| $pocket_edition | |
+| $education_edition | |
+| $world_archive_support | |
+| $file_picking_supported | |
+| $desktop_screen | If the classic UI is selected |
+| $pocket_screen | If the pocket UI is selected |
+| $is_holographic | |
+| $gear_vr | |
+| $oculus_rift | |
+| $is_living_room_mode | |
+| $is_reality_mode | |
+| $realms_beta | |
+| $fire_tv | |
+| $is_ios | |
+| $apple_tv | |
+| $is_windows_10_mobile | |
+| $image_picking_not_supported | |
+| $pre_release | |
+| $ios | |
+| $is_console | |
+| $can_quit | |
+| $is_settopbox | |
+| $microsoft_os | |
+| $apple_os | |
+| $google_os | |
+| $nx_os | |
+| $horizontal_safezone_size | |
+| $vertical_safezone_size | |
+| $can_splitscreen | |
+| $is_secondary_client | |
+| $multiplayer_requires_live_gold | |
+| $xbox_one | |
+| $is_pregame | If it's a out-game screen. It's in-game when you are playing in a world, server or realms |
+| $is_win10_arm | |
+| $vibration_supported | |
+| $is_mobile_vr | |
+| $is_xboxlive_enabled | |
+| $device_must_be_removed_for_xbl_signin | |
+| $is_publish | It's public and not a developer version |
+| $is_desktop | |
+| $is_ps4 | |
+| $is_on_3p_server | |
+| $ignore_3rd_party_servers | |
+| $is_berwick | |
+
+## Hardcoded Hyperlinks
+
+`#hyperlink` doesn't allow custom urls. These are the ones that will work:
+
+- `http://education.minecraft.net/eula`
+- `http://pocketbeta.minecraft.net/p/how-to-join-and-leave-beta.html`
+- `http://aka.ms/minecraftrealmsfb`
+- `http://aka.ms/minecraftrealmsterms`
+- `http://aka.ms/minecraftfb`
+- `http://aka.ms/minecraftedusupport`
+- `https://aka.ms/blockxboxmessages`
+- `http://aka.ms/minecraftfbbeta`
+- `https://minecraft.net/attribution`
+- `http://aka.ms/mcedulogs`
+- `https://minecraft.net/licensed-content/`
+- `https://education.minecraft.net/eula`
+- `https://aka.ms/mcedulogs`
+- `https://aka.ms/minecraftrealmsterms`
+- `https://aka.ms/minecraftfb`
+- `https://aka.ms/minecraftfbbeta`
+- `https://aka.ms/minecraftedusupport`
+- `https://itunes.apple.com/us/app/minecraft/id479516143?mt=8`
+- `https://account.xbox.com/Settings`
+- `https://aka.ms/meeterms`
+- `https://aka.ms/privacy`
+- `https://aka.ms/MCBanned`
+- `https://aka.ms/MCMultiplayerHelp`
+- `https://aka.ms/meeeula`
+- `https://aka.ms/mee_privacy`
+- `https://www.minecraft.net/attribution/?hideChrome`
+- `https://aka.ms/switchattribution`
+- `https://www.minecraft.net/licensed-content/?hideChrome`
+- `https://aka.ms/switchcontent`
+- `https://social.xbox.com/changegamertag`
+
+## Hardcoded Button IDs
+
+Some of them only work in specific screens.
+
+### Buttons IDs:
+
+- `button.menu_exit`
+- `button.menu_cancel` (`Escape` key or Controller `B`)
+- `button.menu_inventory_cancel` (`Open Inventory` keybinding)
+- `button.menu_ok` (`Enter` key)
+- `button.menu_select` (Mouse click)
+- `button.controller_select` (Controller `X`)
+- `button.menu_secondary_select`
+- `button.controller_secondary_select`
+- `button.controller_secondary_select_left`
+- `button.controller_secondary_select_right` (Controller `R3`)
+- `button.controller_start`
+- `button.menu_up` (`Arrow Up` key)
+- `button.menu_down` (`Arrow Down` key)
+- `button.menu_left` (`Arrow Left` key)
+- `button.menu_right` (`Arrow Right` key)
+- `button.menu_tab_left` (`Menu Tab Left` keybinding or Controller `Left Bumper`)
+- `button.menu_tab_right` (`Menu Tab Right` keybinding or Controller `Right Bumper`)
+- `button.menu_alternate_tab_left`
+- `button.menu_alternate_tab_right`
+- `button.menu_autocomplete` (Uses `Tab` key)
+- `button.menu_autocomplete_back`
+- `button.controller_autocomplete`
+- `button.controller_autocomplete_back`
+- `button.menu_textedit_up` (Uses `Arrow Up` key)
+- `button.menu_textedit_down` (Uses `Arrow Down` key)
+- `button.controller_textedit_up`
+- `button.controller_textedit_down`
+- `button.menu_auto_place`
+- `button.menu_inventory_drop` (`Drop Item` keybinding)
+- `button.menu_inventory_drop_all` (`Drop Item` + `Control` key)
+- `button.menu_clear`
+- `button.chat` (`Open Chat` keybinding)
+- `button.mobeffects` (`Mob Effects` keybinding)
+- `key.emote` (`Emote` keybinding)
+- `button.slot1` (Emote Wheel) (`1` key)
+- `button.slot2` (Emote Wheel) (`2` key)
+- `button.slot3` (Emote Wheel) (`3` key)
+- `button.slot4` (Emote Wheel) (`4` key)
+- `button.slot5` (Emote Wheel) (`5` key)
+- `button.slot6` (Emote Wheel) (`6` key)
+- `button.inventory_right` (`Mouse Wheel Up`)
+- `button.inventory_left` (`Mouse Wheel Down`)
+- `button.scoreboard`
+- `button.hide_gui` (`F1` key)
+- `button.hide_tooltips`
+- `button.hide_paperdoll`
+- `button.slot0`
+- `button.slot1` (`1` key)
+- `button.slot2` (`2` key)
+- `button.slot3` (`3` key)
+- `button.slot4` (`4` key)
+- `button.slot5` (`5` key)
+- `button.slot6` (`6` key)
+- `button.slot7` (`7` key)
+- `button.slot8` (`8` key)
+- `button.slot9` (`9` key)
+- `button.menu_vr_realign`
+- `any` (literally the name of it)
+
+### Specific Screen Button IDs:
+
+#### Settings (`ui/settings_screen.json`)
+
+- `button.open_content_log_history`
+- `button.clear_content_log_files`
+- `button.clear_msa_token_button`
+- `button.terms_and_conditions_popup`
+- `button.credits`
+- `button.unlink_msa`
+- `button.attribute_popup`
+- `button.licensed_content`
+- `button.font_license`
+- `button.tos_hyperlink`
+- `button.privpol_hyperlink`
+- `button.tos_popup`
+- `button.privpol_popup`
+- `button.binding_button`
+- `button.reset_binding`
+- `button.reset_keyboard_bindings`
+- `button.view_account_errors`
+
+#### Book (`ui/book_screen.json`)
+
+- `button.prev_page`
+- `button.next_page`
+- `button.book_exit`
+
+#### Chat (`ui/chat_screen.json`)
+
+- `button.send`
+- `button.chat_autocomplete`
+- `button.chat_autocomplete_back`
+- `button.chat_previous_message`
+- `button.chat_next_message`
+- `button.chat_menu_cancel`
+
+#### Command Block (`ui/command_block_screen.json`)
+
+- `command_block.input_minimize`
+- `button.chat_autocomplete`
+- `button.chat_autocomplete_back`
+
+#### Comment (`ui/comment_screen.json`)
+
+- `button.comment_options_close`
+- `button.comment_feed_options_close`
+- `button.close_comments`
+- `button.comment_next_button`
+- `button.comment_prev_button`
+
+#### Credits (`ui/credits_screen.json`)
+
+- `button.show_skip`
+
+#### Death Menu (`ui/death_screen.json`)
+
+- `button.respawn_button`
+- `button.main_menu_button`
+
+#### Emote Wheel (`ui/emote_screen_wheel.json`)
+
+- `button.rebind_mode`
+- `button.dressing_room`
+- `button.emote_selected`
+- `button.select_emote_slot_0`
+- `button.select_emote_slot_1`
+- `button.select_emote_slot_2`
+- `button.select_emote_slot_3`
+- `button.select_emote_slot_4`
+- `button.select_emote_slot_5`
+- `button.iterate_selection_left`
+- `button.iterate_selection_right`
+
+#### Feed (`ui/feed_screen.json`)
+
+- `button.feed_image`
+- `button.newpost`
+- `button.add_screenshot`
+- `button.feed_comment`
+- `button.feed_prev_button`
+- `button.feed_next_button`
+- `button.feed_new_post_close`
+- `button.feed_options_close`
+- `button.close_feed`
+
+#### Game Menu (`ui/pause_screen.json`)
+
+- `button.to_profile_or_skins_screen`
+- `button.player_profile_card`
+- `button.menu_continue`
+- `button.menu_server_store`
+- `button.screenshot`
+- `button.menu_how_to_play`
+- `button.menu_feedback`
+- `button.menu_permission`
+- `button.menu_invite_players`
+- `button.menu_quit`
+- `button.menu_feed`
+- `button.pause_focus_filler`
+
+#### In Bed (`ui/in_bed_screen.json`)
+
+- `button.wake_up_button`
+
+#### Invite (`ui/invite_screen.json`)
+
+- `button.add_friend`
+- `button.add_member`
+- `button.send_invites`
+
+#### Manage Feed (`ui/manage_feed_screen.json`)
+
+- `button.manage_feed_prev_button`
+- `button.manage_feed_next_button`
+- `button.manage_feed_ignore`
+- `button.manage_feed_delete`
+- `button.close_manage_feed`
+
+#### Anvil (`ui/anvil_screen.json`)
+
+- `button.anvil_take_all_place_all`
+- `button.anvil_coalesce_stack`
+
+#### Cartography Table (`ui/cartography_screen.json`)
+
+- `button.cartography_result_take_all_place_all`
+
+#### Enchanting Table (`ui/enchanting_table_screen.json`)
+
+- `button.enchant`
+
+#### Grindstone (`ui/grindstone_screen.json`)
+
+- `button.grindstone_take_all_place_all`
+- `button.grindstone_coalesce_stack`
+
+#### Loom (`ui/loom_screen.json`)
+
+- `button.loom_result_take_all_place_all`
+- `button.pattern_select`
+
+#### Villager Trade (`ui/trade_screen.json`)
+
+- `button.cycle_recipe_left`
+- `button.cycle_recipe_right`
+- `button.trade_take_all_place_all`
+- `button.trade_take_half_place_one`
+- `button.trade_coalesce_stack`
+
+#### Play (`ui/play_screen.json`)
+
+- `button.menu_sign_in_to_view_realms`
+- `button.menu_realms_world_item_edit`
+- `button.menu_realms_feed`
+- `button.menu_realms_world_item_remove`
+- `button.menu_network_world_item`
+- `button.menu_network_server_world_edit`
+- `button.connect_to_third_party_server`
+- `button.view_third_party_server_offers`
+- `button.description_read_toggle`
+- `button.news_read_toggle`
+- `button.local_world_upload`
+- `button.menu_start_local_world`
+- `button.convert_legacy_world`
+- `button.menu_local_world_item_edit`
+- `button.menu_legacy_world_item_delete`
+- `button.import_beta_retail_local_world`
+- `button.import_beta_retail_legacy_world`
+- `button.menu_network_add_friend`
+- `button.menu_network_join_by_code`
+- `button.menu_quick_play`
+- `button.new_world_upload`
+- `button.menu_local_world_create`
+- `button.create_on_realms_button`
+- `button.archived_world_upload`
+- `button.menu_import_level`
+- `button.menu_sync_legacy_worlds`
+- `button.realms_warning_more_info`
+- `button.menu_realm_world_trial`
+- `button.menu_realm_nintendo_first_realm_purchase_button`
+- `button.no_local_worlds_launch_help`
+- `button.menu_network_join_by_code_popup_join`
+- `button.join_server_anyway`
+- `button.cancel_join_server`
+
+### Others
+
+- `button.try_menu_exit`
+- `button.close_dialog`
+- `button.menu_play`
+- `$play_button_target` (**hardcoded**)
+- `button.menu_store`
+- `button.menu_achievements`
+- `button.menu_settings`
+- `button.signin`
+- `button.menu_skins`
+- `button.to_profile_screen`
+- `button.menu_courses`
+- `button.menu_tutorial`
+- `button.featured_world`
+- `button.switch_accounts`
+- `button.launch_editions`
+- `button.edu_feedback`
+- `button.edu_resources`
+- `button.menu_buy_game`
+- `button.menu_invite_notification`
+- `button.search`
+- `button.hotbar_inventory_button`
+- `button.select_offer`
+- `button.action_button`
+- `button.create_realm`
+- `button.switch_accounts`
+- `button.hotbar_select`
+- `button.hotbar_ok`
+- `button.slot_pressed`
+- `button.hotbar_inventory_left`
+- `button.hotbar_inventory_right`
+- `button.hide_gui_all`
+- `button.hide_tooltips_hud`
+- `button.hide_paperdoll_hud`
+- `button.slot_1`
+- `button.slot_2`
+- `button.slot_3`
+- `button.slot_4`
+- `button.slot_5`
+- `button.slot_6`
+- `button.slot_7`
+- `button.slot_8`
+- `button.slot_9`
+- `button.slot_0`
+- `button.chat`
+- `button.menu_continue`
+- `user_confirm_dialog.escape`
+- `user_confirm_dialog.left_button`
+- `user_confirm_dialog.middle_button`
+- `user_confirm_dialog.rightcancel_button`
+- `button.view_skin`
+- `button.delete_action`
+- `button.exit_student`
+- `button.play_video`
+- `button.menu_store_error`
+- `button.left_panel_tab_increment`
+- `button.left_panel_tab_decrement`
+- `button.right_panel_tab_increment`
+- `button.right_panel_tab_decrement`
+- `button.layout_increment`
+- `button.layout_decrement`
+- `button.is_hovered`
+- `button.container_take_all_place_all`
+- `button.container_take_half_place_one`
+- `button.container_auto_place`
+- `button.coalesce_stack`
+- `button.shape_drawing`
+- `button.destroy_selection`
+- `button.clear_selected_recipe`
+- `button.clear_hotbar_or_remove_one`
+- `button.clear_hotbar_or_drop`
+- `button.container_reset_held`
+- `button.container_auto_place`
+- `button.container_slot_hovered`
+- `button.button_hovered`
+- `button.shift_pane_focus`
+- `button.focus_left`
+- `button.focus_right`
+- `button.filter_toggle_hovered`
+- `button.drop_one`
+- `button.cursor_drop_one`
+- `button.drop_all`
+- `button.cursor_drop_all`
+- `button.search_bar_clear`
+- `button.search_bar_selected`
+- `button.search_bar_deselected`
+- `button.menu_leave_screen`
+- `button.turn_doll`
+- `button.select_skin`
+- `button.skin_hovered`
+- `button.skin_unhovered`
+- `button.leave`
+- `button.leave_on_device`
+- `button.text_edit_box_selected`
+- `button.text_edit_box_deselected`
+- `button.text_edit_box_hovered`
+- `button.text_edit_box_clear`
+- `button.help`
+- `button.menu_open_uri`
+- `button.no_interaction`
+- `button.copy_to_clipboard`
+- ...
+
+## Hardcoded Collection Names
+
+All of them only in specific screens.
+
+### Screen specific:
+
+#### Book (`ui/book_screen.json`)
+
+- `book_pages`
+- `pick_collection`
+
+#### Bundle Purchase Warning (`ui/bundle_purchase_warning_screen.json`)
+
+- `owned_list`
+- `unowned_list`
+
+#### Chat (`ui/chat_screen.json`)
+
+- `auto_complete`
+- `font_colors`
+- `host_main_collection`
+- `players_collection`
+- `host_teleport_collection`
+- `host_time_collection`
+- `host_weather_collection`
+
+#### Choose Realm (`ui/choose_realm_screen.json`)
+
+- `realms_collection`
+
+#### Coin Purchase (`ui/coin_purchase_screen.json`)
+
+- `coin_purchase_grid`
+
+#### Comment (`ui/comment_screen.json`)
+
+- `comment_collection`
+
+#### Content Log History (`ui/content_log_history_screen.json`)
+
+- `content_log_message`
+
+#### Create World Upsell (`ui/create_world_upsell_screen.json`)
+
+- `world_list`
+- `realm_list`
+
+#### Custom Templates (`ui/custom_templates_screen.json`)
+
+- `templates_collection`
+
+#### Feed (`ui/feed_screen.json`)
+
+- `feed_collection`
+
+#### HUD (`ui/hud_screen.json`)
+
+- `boss_bars`
+- `chat_text_grid`
+- `hotbar_items`
+- `scoreboard_players`
+- `scoreboard_scores`
+- `left_helper_collection`
+- `right_helper_collection`
+
+#### Invite (`ui/invite_screen.json`)
+
+- `online_platform_friends`
+- `online_linked_account_friends`
+- `online_xbox_live_friends`
+- `offline_platform_friends`
+- `offline_linked_account_friends`
+- `offline_xbox_live_friends`
+
+#### Manage Feed (`ui/manage_feed_screen.json`)
+
+- `manage_feed_collection`
+
+#### Manifest Validation (`manifest_validation_screen.json`)
+
+- `pack_errors`
+
+#### Mob Effects (`ui/mob_effects_screen.json`)
+
+- `mob_effects_collection`
+
+#### Game Menu (`ui/pause_screen.json`)
+
+- `players_collection`
+
+#### PDP (`ui/pdp_screen.json`)
+
+- `factory_collection`
+- `ratings_star_collection`
+
+#### Permissions (`ui/permissions_screen.json`)
+
+- `players_collection` - it's also used in `pause_screen.json`
+- `permissions_collection`
+
+#### Persona (`ui/persona_screen.json`)
+
+- `color_collection`
+- `skin_pack_in_grid_item`
+- `persona_featured_skin_pack_collection`
+- `body_size_collection`
+- `arm_size_collection`
+- `category_featured_collection`
+- `main_featured_collection`
+- `profile_featured_collection`
+- `custom_section_collection`
+- `featured_collection`
+- `foobar_collection`
+- `emote_collection`
+
+#### Play (`ui/play_screen.json`)
+
+- `friends_network_worlds`
+- `cross_platform_friends_network_worlds`
+- `lan_network_worlds`
+- `personal_realms`
+- `friends_realms`
+- `servers_network_worlds`
+- `third_party_server_network_worlds`
+- `server_screenshot_collection`
+- `server_games_collection`
+- `local_worlds`
+- `legacy_worlds`
+- `beta_retail_local_worlds`
+- `personal_realms`
+- `loading_personal_realms`
+- `friends_realms`
+- `loading_friends_realms`
+
+#### Portfolio (`ui/portfolio_screen.json`)
+
+- `photos`
+
+#### Progress (`ui/progress_screen.json`)
+
+- `required_resourcepacks`
+- `optional_resourcepacks`
+
+#### Realms Pending Invitations (`ui/realms_pending_invitations_screen.json`)
+
+- `pending_invites_collection`
+
+#### Realms Settings (`ui/realms_settings_screen.json`)
+
+- `additional_realms_subscriptions_collection`
+- `realms_branch_collection`
+- `realms_backup_collection`
+- `members_collection`
+- `invited_friends_collection`
+- `uninvited_friends_collection`
+- `blocked_players_collection`
+
+#### Screenshot Picker (`ui/screenshot_picker_screen.json`)
+
+- `screenshotpicker_collection`
+
+#### Server Form (`ui/server_form.json`)
+
+- `custom_form`
+- `form_buttons`
+- `custom_dropdown`
+
+#### Settings (`ui/settings_screen.json`)
+
+- `keyboard_standard_collection`
+- `keyboard_full_collection`
+- `gamepad_collection`
+- `languages`
+- `realms_plus_subscriptions_collection`
+- `additional_realms_subscriptions_collection`
+- `#selected_pack_items_global`
+- `#available_pack_items_global`
+- `#realms_pack_items_global`
+- `#unowned_pack_items_global`
+- `#invalid_pack_items_global`
+- `#selected_pack_items_level`
+- `#available_pack_items_level`
+- `#realms_pack_items_level`
+- `#unowned_pack_items_level`
+- `#invalid_pack_items_level`
+- `#selected_pack_items_addon`
+- `#available_pack_items_addon`
+- `#realms_pack_items_addon`
+- `#unowned_pack_items_addon`
+- `#invalid_pack_items_addon`
+- `experimental_toggles`
+- `world_panel`
+- `world_template_panel`
+- `resource_panel`
+- `behavior_panel`
+- `skin_panel`
+- `cache_panel`
+- `dependent_packs_panel`
+- `dependency_panel`
+
+#### Structure Block (`ui/structure_editor_screen.json`)
+
+- `save_size_grid`
+- `save_offset_grid`
+- `load_offset_grid`
+- `export_size_grid`
+- `export_offset_grid`
+
+#### Seed Picker (`ui/ugc_viewer_screen.json`)
+
+- `ugc_items`
+
+#### World Templates (`ui/world_templates_screen.json`)
+
+- `world_templates`
+- `realms_plus_templates`
+- `custom_world_templates`
+- `#suggested_offers_collection`
+
+#### Anvil (`ui/anvil_screen.json`)
+
+- `anvil_input_items`
+- `anvil_material_items`
+- `anvil_result_items`
+
+#### Beacon (`ui/beacon_screen.json`)
+
+- `beacon_payment_items`
+- `speed`
+- `haste`
+- `resist`
+- `jump`
+- `strength`
+- `regen`
+- `extra`
+- `confirm`
+- `cancel`
+
+#### Brewing Stand (`ui/brewing_stand_screen.json`)
+
+- `brewing_fuel_item`
+- `brewing_input_item`
+- `brewing_result_items`
+
+#### Cartography Table (`ui/cartography_screen.json`)
+
+- `cartography_input_items`
+- `cartography_additional_items`
+- `cartography_result_items`
+
+#### Enchanting Table (`ui/enchanting_table_screen.json`)
+
+- `enchanting_input_items`
+- `enchanting_lapis_items`
+- `#enchant_buttons`
+
+#### Furnace (`ui/furnace_screen.json`)
+
+- `furnace_ingredient_items`
+- `furnace_fuel_items`
+- `furnace_output_items`
+
+#### Gridstone (`ui/grindstone_screen.json`)
+
+- `grindstone_input_items`
+- `grindstone_additional_items`
+- `grindstone_result_items`
+
+#### Horse (`ui/horse_screen.json`)
+
+- `horse_equip_items`
+
+#### Inventory (`ui/inventory_screen.json` and `ui/inventory_screen_pocket.json`)
+
+- `armor_items`
+- `offhand_items`
+- `crafting_input_items`
+- `crafting_output_items`
+- `recipe_book`
+
+#### Loom (`ui/loom_screen.json`)
+
+- `loom_input_items`
+- `loom_dye_items`
+- `loom_material_items`
+- `loom_result_items`
+- `patterns`
+
+#### Smithing Table (`ui/smithing_table_screen.json`)
+
+- `smithing_table_input_items`
+- `smithing_table_material_items`
+- `smithing_table_result_items`
+
+#### Stonecutter (`ui/stonecutter_screen.json`)
+
+- `stonecutter_input_items`
+- `stonecutter_result_items`
+- `stones`
+
+#### Villager Trade 2 (`ui/trade_2_screen.json`)
+
+- `trade2_ingredient1_item`
+- `trade2_ingredient2_item`
+- `trade2_result_item`
+- `trade_item_1`
+- `trade_item_2`
+- `sell_item`
+- `trades`
+- `trade_tiers`
+
+## Hardcoded Binding Names
+
+Some of them only work in specific screens.
+
+### Screen specific:
+
+#### Account Transfer Error (`ui/account_transfer_error_screen.json`)
+
+- `#error_title_text`
+- `#error_number_label`
+- `#error_number`
+- `#correlation_id_label`
+- `#correlation_id`
+
+#### Add External Server (`ui/add_external_server_screen.json`)
+
+- `#play_button_enabled`
+- `#play_button_disabled`
+- `#save_button_enabled`
+- `#save_button_disabled`
+
+#### Adhoc In Progress (`ui/adhoc_in_progress_screen.json`)
+
+- `#adhoc_title`
+
+#### Authentication (`ui/authentication_screen.json`)
+
+- `#sign_in_visible`
+- `#sign_in_ios_visible`
+- `#sign_in_button_visible`
+- `#sign_in_ios_buttons_visible`
+- `#authentication_message`
+- `#confirm_button_enabled`
+- `#edu_store_visible`
+- `#edu_store_purchase_info`
+- `#asking_to_buy_visible`
+- `#confirming_purchase_visible`
+- `#demo_choice_visible`
+- `#eula_visible`
+- `#popup_text`
+- `#popup_message_student_text`
+- `#popup_message_student_visible`
+- `#generic_popup_link_visible`
+- `#trial_purchase_link_visible`
+- `#show_popup_dismiss_button`
+
+#### Book (`ui/book_screen.json`)
+
+- `#screenshot_path`
+- `#is_photo_page`
+- `#is_text_page`
+- `#pick_grid_dimensions`
+- `#page_number`
+- `#title_text_box_item_name`
+- `#author_editable`
+- `#author_text_box_item_name`
+- `#editable`
+- `#viewing`
+- `#signing`
+- `#picking`
+- `#exporting`
+- `#page_visible`
+- `#pick_item_visible`
+- `#close_button_visible`
+- `#edit_controls_active`
+- `#finalize_button_enabled`
+
+#### Braze (`ui/braze_screen.json`)
+
+- `#image_texture`
+
+#### Bundle Purchase Warning (`ui/bundle_purchase_warning_screen.json`)
+
+- `#banner_visible`
+- `#offer_title`
+- `#keyart_path`
+- `#keyart_texture_file_system`
+
+#### Chat (`ui/chat_screen.json`)
+
+- `#keyboard_being_use`
+- `#keyboard_button_focus_override_up`
+- `#keyboard_button_focus_override_down`
+- `#keyboard_button_visible`
+- `#send_button_visible`
+- `#send_button_accessibility_text`
+- `#chat_visible`
+- `#message_text_box_content`
+- `#text_edit_box_focus_override_up`
+- `#text_edit_box_focus_override_down`
+- `#auto_complete_item`
+- `#auto_complete_text`
+- `#get_grid_size`
+- `#chat_title_text`
+- `#chat_typeface_visible`
+
+#### Choose Realm (`ui/choose_realm_screen.json`)
+
+- `#realms_grid_dimension`
+- `#world_button_focus_identifier`
+- `#ten_player_button_visible`
+- `#two_player_button_visible`
+- `#realms_world_player_count`
+- `#realms_game_online`
+- `#realms_game_unavailable`
+- `#realms_game_offline`
+
+#### Coin Purchase (`ui/coin_purchase_screen.json`)
+
+- `#bonus_coins`
+- `#coins_without_bonus`
+- `#coin_offer_texture_name`
+- `#coin_offer_texture_file_system`
+- `#bonus_coins_visible`
+- `#price_text`
+- `#coins_required_for_purchase`
+- `#show_missing_coins`
+- `#coin_offer_size`
+- `#has_coin_offers`
+- `#coin_loading_visible`
+
+#### Command Block (`ui/command_block_screen.json`)
+
+- `#maximized_input_visible`
+- `#block_type_icon_texture`
+- `#close_button_visible_binding_name`
+- `#command_impulse_mode`
+- `#command_chain_mode`
+- `#command_repeat_mode`
+- `#block_type_dropdown_toggle_label`
+- `#block_type_dropdown_label_color_binding`
+- `#block_type_dropdown_enabled`
+- `#command_conditional_mode`
+- `#command_unconditional_mode`
+- `#condition_dropdown_toggle_label`
+- `#condition_dropdown_enabled`
+- `#command_always_on_mode`
+- `#command_needs_redstone_mode`
+- `#redstone_dropdown_enabled`
+- `#command_hover_note`
+- `#execute_on_first_tick_enabled`
+- `#command_tick_delay`
+- `#command_text_edit`
+- `#command_output_text`
+- `#previous_block_type_text`
+- `#previous_block_type_text_color`
+- `#previous_condition_mode_text`
+- `#previous_redstone_mode_text`
+- `#minimize_button_visible_binding_name`
+
+#### Comment (`ui/comment_screen.json`)
+
+- `#report_to_club_button_visible_feeditem`
+- `#report_to_enforcement_button_visible_feeditem`
+- `#delete_button_visible_feeditem`
+- `#report_to_club_button_visible_comment`
+- `#report_to_enforcement_button_visible_comment`
+- `#delete_button_visible_comment`
+- `#comment_buttons_visible`
+- `#feed_comment_page_collection_length`
+- `#comment_content`
+- `#is_author_linked_account`
+- `#content`
+- `#text_visible`
+- `#likes_and_comments`
+- `#screenshot_texture`
+- `#screenshot_texture_source`
+- `#textpost_content`
+- `#textpost_visible`
+- `#comment_text_box`
+- `#comment_platform_tag`
+- `#comment_gamertag`
+- `#likes_and_time_since_comment_post`
+- `#author_gamertag`
+- `#time_since_feed_post`
+- `#author_platform_tag`
+- `#author_gamertag`
+
+#### Confirm MSA Unlink (`ui/confirm_msa_unlink_screen.json`)
+
+- `#unlink_warning_text`
+- `#unlink_consequences_acknowledged`
+- `#confirm_0`
+- `#confirm_0_enabled`
+- `#confirm_1`
+- `#confirm_1_enabled`
+- `#confirm_2`
+- `#confirm_2_enabled`
+- `#confirm_3`
+- `#confirm_3_enabled`
+
+#### Content Log History (`ui/content_log_history_screen.json`)
+
+- `#content_log_text`
+- `#messages_size`
+
+#### Create World Upsell (`ui/create_world_upsell.json`)
+
+- `#realm_button_text`
+- `#realm_trial_available`
+
+#### Anvil (`ui/anvil_screen.json`)
+
+- `#cost_text`
+- `#cost_text_green`
+- `#cost_text_red`
+
+#### Beacon (`ui/beacon_screen.json`)
+
+- `#supports_netherite`
+- `#extra_image_selection`
+
+#### Brewing Stand (`ui/brewing_stand_screen.json`)
+
+- `#empty_bottle_image_visible`
+- `#empty_fuel_image_visible`
+- `#brewing_bubbles_ratio`
+- `#brewing_fuel_ratio`
+- `#brewing_arrow_ratio`
+
+#### Cartography Table (`ui/cartography_screen.json`)
+
+- `#is_none_mode`
+- `#is_clone_mode`
+- `#is_rename_mode`
+- `#is_basic_map_mode`
+- `#is_locator_map_mode`
+- `#is_extend_mode`
+- `#is_locked_mode`
+- `#output_description`
+
+#### Enchanting Table (`ui/enchanting_table_screen.json`)
+
+- `#selectable_dust_is_visible`
+- `#unselectable_dust_is_visible`
+- `#runes`
+- `#cost`
+- `#unselectable_button_visibility`
+- `#selectable_button_visibility`
+- `#show_selected_button_highlight`
+- `#active_enchant`
+- `#inactive_enchant`
+- `#input_item_id`
+- `#output_item_id`
+- `#enchant_hint`
+- `#player_level_color`
+- `#player_level_info`
+- `#enchant_error`
+
+#### Furnace (`ui/furnace_screen.json`)
+
+- `#furnace_arrow_ratio`
+- `#furnace_flame_ratio`
+- `#output_name`
+
+#### Horse (`ui/horse_screen.json`)
+
+- `#entity_id`
+- `#equip_grid_dimensions`
+- `#inv_grid_dimensions`
+- `#sadle_slot_centered`
+- `#has_saddle_slot`
+- `#has_armor_slot`
+- `#has_only_armor_slot`
+- `#has_only_carpet_slot`
+- `#has_armor_and_saddle_slot`
+- `#has_carpet_and_saddle_slot`
+- `#is_chested`
+- `#renderer_tab_toggle`
+- `#chest_tab_toggle`
+
+#### Loom (`ui/loom_screen.json`)
+
+- `#pattern_cell_background_texture`
+- `#container_cell_background_texture`
+- `#empty_image_visible`
+- `#banner_patterns`
+- `#banner_colors`
+- `#pattern_selector_total_items`
+- `#result_patterns`
+- `#result_colors`
+- `#is_right_tab_loom`
+- `#is_left_tab_patterns`
+
+#### Stonecutter (`ui/stonecutter_screen.json`)
+
+- `#stone_cell_background_texture`
+- `#container_cell_background_texture`
+- `#item_stack_count`
+- `#stone_selector_total_items`
+- `#has_input_item`
+- `#is_right_tab_stonecutter`
+- `#is_left_tab_stones`
+
+#### Death (`ui/death_screen.json`)
+
+- `#death_reason_text`
+- `#respawn_visible`
+- `#quit_enabled`
+- `#quit_visible`
+- `#buttons_and_deathmessage_visible`
+
+#### Villager Trade2 (`ui/trade2_screen.json`)
+
+- `#name_label`
+- `#trade_cell_background_texture`
+- `#trade_item_count`
+- `#single_slash_visible`
+- `#double_slash_visible`
+- `#second_trade_item_count`
+- `#trade_price_different`
+- `#trade_cross_out_visible`
+- `#padding_around_sell_item`
+- `#trade_possible`
+- `#trade_toggle_state`
+- `#trade_toggle_enabled`
+- `#trade_tier_total`
+- `#tier_name`
+- `#is_tier_unlocked`
+- `#is_left_tab_trade`
+- `#show_level`
+- `#tier_visible`
+- `#trade_selector_total`
+- `#has_second_buy_item`
+- `#exp_bar_visible`
+- `#exp_progress`
+- `#exp_possible_progress`
+- `#trade_details_button_1_visible`
+- `#trade_details_button_2_visible`
+- `#enchantment_details_button_visible`
+- `#item_valid`
+
+### Value depends on the screen it is in:
+
+- `#title_text`
+- `#body_text`
+- `#hover_text`
+- `#cross_out_icon`
+- `#is_left_tab_inventory`
+- `#selected_hover_text`
+
+### Others:
+
+- `#tts_dialog_body`
+- `#button_enabled`
+- `#using_touch`
+- `#close_button_visible`
+
+## Settings
+
+### Sliders
+
+| Name | Slider Name | Value Binding Name | TTS Value (`tts_value_changed`) | Slider Text | Enabled Binding Name |
+| ------------------------- | ------------------------------- | -------------------------------- | ------------------------------- | --------------------------------------------- | ---------------------------------------- |
+| Brightness | `gamma` | `#gamma` | `#gamma_text_value` | `#gamma_slider_label` | `#gamma_enabled` |
+| Brightness (VR) | `vr_gamma` | `#vr_gamma` | `#vr_gamma_text_value` | `#vr_gamma_slider_label` | `#vr_gamma_enabled` |
+| HUD Opacity | `interface_opacity` | `#interface_opacity` | `#interface_opacity_text_value` | `#interface_opacity_slider_label` | `#interface_opacity_enabled` |
+| HUD Opacity (Splitscreen) | `splitscreen_interface_opacity` | `#splitscreen_interface_opacity` | `#interface_opacity_text_value` | `#splitscreen_interface_opacity_slider_label` | `#splitscreen_interface_opacity_enabled` |
+| Field Of View | `field_of_view` | `#field_of_view` | `#field_of_view_text_value` | `#field_of_view_slider_label` | `#field_of_view_enabled` |
+
+### Toggles
+
+| Name | Toggle Name | State Binding Name | Enabled Binding Name |
+| --------------------------------------- | ------------------------------------- | -------------------------------------- | ---------------------------------------------- |
+| Invert Y Axis (Mouse) | `keyboard_mouse_invert_y_axis` | `#keyboard_mouse_invert_y_axis` | `#keyboard_mouse_invert_y_axis_enabled` |
+| Auto Jump (Mouse) | `keyboard_mouse_autojump` | `#keyboard_mouse_autojump` | `#keyboard_mouse_autojump_enabled` |
+| Show Full Keyboard Options | `keyboard_show_full_keyboard_options` | `#keyboard_show_full_keyboard_options` | `#keyboard_show_full_keyboard_options_enabled` |
+| Hide Keyboard Tooltips | `hide_keyboard_tooltips` | `#hide_keyboard_tooltips` | `#hide_keyboard_tooltips_enabled` |
+| Content File Log | `content_log_file` | `#content_log_file` | `#content_log_file_enabled` |
+| Content Gui Log | `content_log_gui` | `#content_log_gui` | `#content_log_gui_enabled` |
+| Use SSO | `ad_use_single_sign_on` | `#ad_use_single_sign_on` | |
+| Auto Update OFF | `#auto_update_mode_off` | `#auto_update_mode_off` | |
+| Auto Update ON with Cellular | `#auto_update_mode_on_with_cellular` | `#auto_update_mode_on_with_cellular` | |
+| Auto Update on WiFi Only | `#auto_update_mode_on_wifi_only` | `#auto_update_mode_on_wifi_only` | |
+| Auto Update Enabled | `auto_update_enabled` | `#auto_update_enabled` | |
+| Cross Platform Enabled | `crossplatform_toggle` | `#crossplatform_toggle` | `#crossplatform_toggle_enabled` |
+| Allow Cellular Data | `allow_cellular_data` | `#allow_cellular_data` | `#allow_cellular_data_enabled` |
+| Websocket Encryption | `websocket_encryption` | `#websocket_encryption` | `#websocket_encryption_enabled` |
+| Only Trusted Skins Allowed | `only_trusted_skins_allowed` | `#only_trusted_skins_allowed` | `#only_trusted_skins_allowed_enabled` |
+| Storage Location External | `#storage_location_radio_external` | `#storage_location_radio_external` | `#file_storage_location_enabled` |
+| Storage Location App | `#storage_location_radio_package` | `#storage_location_radio_package` | `#file_storage_location_enabled` |
+| First Person Perspective | `#thirdperson_radio_first` | `#thirdperson_radio_first` | `#third_person_dropdown_enabled` |
+| Third Person Back Perspective | `#thirdperson_radio_third_back` | `#thirdperson_radio_third_back` | `#third_person_dropdown_enabled` |
+| Third Person Front Perspective | `#thirdperson_radio_third_front` | `#thirdperson_radio_third_front` | `#third_person_dropdown_enabled` |
+| Fullscreen | `full_screen` | `#full_screen` | `#full_screen_enabled` |
+| Hide Hand | `hide_hand` | `#hide_hand` | `#hide_hand_enabled` |
+| Hide Hand (VR) | `vr_hide_hand` | `#vr_hide_hand` | `#vr_hide_hand_enabled` |
+| Hide Paperdoll | `hide_paperdoll` | `#hide_paperdoll` | `#hide_paperdoll_enabled` |
+| Hide HUD | `hide_hud` | `#hide_hud` | `#hide_hud_enabled` |
+| Hide HUD (VR) | `vr_hide_hud` | `#vr_hide_hud` | `#vr_hide_hud_enabled` |
+| Screen Animations | `screen_animations` | `#screen_animations` | `#screen_animations_enabled` |
+| Split Screen Horizontally | `#split_screen_radio_horizontal` | `#split_screen_radio_horizontal` | `#split_screen_dropdown_enabled` |
+| Split Screen Vertically | `#split_screen_radio_vertical` | `#split_screen_radio_vertical` | `#split_screen_dropdown_enabled` |
+| Show Auto Save Icon | `show_auto_save_icon` | `#show_auto_save_icon` | `#show_auto_save_icon_enabled` |
+| Outline Selection | `classic_box_selection` | `#classic_box_selection` | `#classic_box_selection_enabled` |
+| Outline Selection (VR) | `vr_classic_box_selection` | `#vr_classic_box_selection` | `#vr_classic_box_selection_enabled` |
+| Show Players Names Ingame | `ingame_player_names` | `#ingame_player_names` | `#ingame_player_names_enabled` |
+| Show Players Names Ingame (Splitscreen) | `splitscreen_ingame_player_names` | `#splitscreen_ingame_player_names` | `#splitscreen_ingame_player_names_enabled` |
+| View Bobbing | `view_bobbing` | `#view_bobbing` | `#view_bobbing_enabled` |
+| Camera Shake | `camera_shake` | `#camera_shake` | `#camera_shake_enabled` |
+| Fancy Leaves | `transparent_leaves` | `#transparent_leaves` | `#transparent_leaves_enabled` |
+| Fancy Leaves (VR) | `vr_transparent_leaves` | `#vr_transparent_leaves` | `#vr_transparent_leaves_enabled` |
+| Fancy Bubbles | `bubble_particles` | `#bubble_particles` | `#bubble_particles_enabled` |
+| Render Clouds | `render_clouds` | `#render_clouds` | `#render_clouds_enabled` |
+| Fancy Clouds | `fancy_skies` | `#fancy_skies` | `#fancy_skies_enabled` |
+| Smooth Lighting | `smooth_lighting` | `#smooth_lighting` | `#smooth_lighting_enabled` |
+| Smooth Lighting (VR) | `graphics_toggle` | `#graphics_toggle` | `#graphics_toggle_enabled` |
+| Graphics | `graphics_toggle` | `#graphics_toggle` | `#graphics_toggle_enabled` |
+| Field of View | `field_of_view_toggle` | `#field_of_view_toggle` | `#field_of_view_toggle_enabled` |
+| Classic UI Profile | `#ui_profile_radio_classic` | `#ui_profile_radio_classic` | `#ui_profile_dropdown_enabled` |
+| Pocket UI Profile | `#ui_profile_radio_pocket` | `#ui_profile_radio_pocket` | `#ui_profile_dropdown_enabled` |
+| Texel Anti-Aliasing | `texel_aa` | `#texel_aa` | `#texel_aa_enabled` |
+| 3D Rendering (VR) | `vr_3d_rendering` | `#vr_3d_rendering` | `#vr_3d_rendering_enabled` |
+| Mirror Texture (VR) | `vr_mirror_texture` | `#vr_mirror_texture` | `#vr_mirror_texture_enabled` |
+| Hand Pointer Visible (VR) | `vr_hand_pointer` | `#vr_hand_pointer` | `#vr_hand_pointer_enabled` |
+| Hands Visible (VR) | `vr_hands_visible` | `#vr_hands_visible` | `#vr_hands_visible_enabled` |
+| Enable Auto TTS | `enable_auto_text_to_speech` | `#enable_auto_text_to_speech` | `#enable_auto_text_to_speech_enabled` |
+| Enable UI TTS | `enable_ui_text_to_speech` | `#enable_ui_text_to_speech` | `#enable_ui_text_to_speech_enabled` |
+| Enable Chat TTS | `enable_chat_text_to_speech` | `#enable_chat_text_to_speech` | `#enable_chat_text_to_speech_enabled` |
+| Enable Open Chat Message | `enable_open_chat_message` | `#enable_open_chat_message` | `#enable_open_chat_message_enabled` |
+| Camera Shake | `camera_shake` | `#camera_shake` | `#camera_shake_enabled` |
+| Languages (Collection) | `languages` | `#language_initial_selected` | |
+
+## Item ID Aux (`#item_id_aux`)
+
+| Name | ID | Aux Values |
+| ----------------- | :--: | :--------: |
+| diamond | 306 | 20054016 |
+| emerald | 519 | 34013184 |
+| gold_ingot | 308 | 20185088 |
+| iron_ingot | 307 | 20119552 |
+| netherite_ingot | 616 | 40370176 |
+| banner | 574 | 37617664 |
+| saddle | 373 | 24444928 |
+| cartography_table | -200 | -13107200 |
+| chest | 54 | 3538944 |
+| crafting_table | 58 | 3801088 |
+| loom | -204 | -13369344 |
+| stonecutter_block | -197 | -12910592 |
+
+#### How to calculate block item aux value:
+
+Aux = ID \* 65536
+
+ID = Aux / 65536
+65536 = Aux / ID
+
+Get all Item IDs [here](https://docs.microsoft.com/en-us/minecraft/creator/reference/content/addonsreference/examples/addonitems).
diff --git a/docs/wiki/bedrock-wiki-mirror.md b/docs/wiki/bedrock-wiki-mirror.md
new file mode 100644
index 00000000..e27873f4
--- /dev/null
+++ b/docs/wiki/bedrock-wiki-mirror.md
@@ -0,0 +1,7 @@
+---
+hidden: true
+---
+
+:::details 本页面镜像自 [BedrockWiki](https://wiki.bedrock.dev)
+根据原始项目协议授权。本文经过AI翻译处理，如有内容遗漏，可以提交PR进行补充。
+:::
\ No newline at end of file
diff --git a/entities/vuc-full b/entities/vuc-full
new file mode 100644
index 00000000..e69de29b
diff --git a/package-lock.json b/package-lock.json
index 18ccf52f..a92fb0c3 100644
--- a/package-lock.json
+++ b/package-lock.json
@@ -16,6 +16,7 @@
"gray-matter": "^4.0.3",
"marked": "^15.0.7",
"mermaid": "^11.5.0",
+ "openai": "^4.87.4",
"vitepress": "^1.6.3",
"vitepress-plugin-mermaid": "^2.0.17",
"vue": "^3.5.13"
@@ -1709,6 +1710,17 @@
"undici-types": "~6.20.0"
}
},
+ "node_modules/@types/node-fetch": {
+ "version": "2.6.12",
+ "resolved": "https://registry.npmjs.org/@types/node-fetch/-/node-fetch-2.6.12.tgz",
+ "integrity": "sha512-8nneRWKCg3rMtF69nLQJnOYUcbafYeFSjqkw3jCRLsqkWFlHaoQrr5mXmofFGOx3DKn7UfmBMyov8ySvLRVldA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "@types/node": "*",
+ "form-data": "^4.0.0"
+ }
+ },
"node_modules/@types/trusted-types": {
"version": "2.0.7",
"resolved": "https://registry.npmjs.org/@types/trusted-types/-/trusted-types-2.0.7.tgz",
@@ -2003,6 +2015,19 @@
"url": "https://github.com/sponsors/antfu"
}
},
+ "node_modules/abort-controller": {
+ "version": "3.0.0",
+ "resolved": "https://registry.npmjs.org/abort-controller/-/abort-controller-3.0.0.tgz",
+ "integrity": "sha512-h8lQ8tacZYnR3vNQTgibj+tODHI5/+l06Au2Pcriv/Gmet0eaj4TwWH41sO9wnHDiQsEj19q0drzdWdeAHtweg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "event-target-shim": "^5.0.0"
+ },
+ "engines": {
+ "node": ">=6.5"
+ }
+ },
"node_modules/acorn": {
"version": "8.14.1",
"resolved": "https://registry.npmjs.org/acorn/-/acorn-8.14.1.tgz",
@@ -2016,6 +2041,19 @@
"node": ">=0.4.0"
}
},
+ "node_modules/agentkeepalive": {
+ "version": "4.6.0",
+ "resolved": "https://registry.npmjs.org/agentkeepalive/-/agentkeepalive-4.6.0.tgz",
+ "integrity": "sha512-kja8j7PjmncONqaTsB8fQ+wE2mSU2DJ9D4XKoJ5PFWIdRMa6SLSN1ff4mOr4jCbfRSsxR4keIiySJU0N9T5hIQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "humanize-ms": "^1.2.1"
+ },
+ "engines": {
+ "node": ">= 8.0.0"
+ }
+ },
"node_modules/algoliasearch": {
"version": "5.21.0",
"resolved": "https://registry.npmjs.org/algoliasearch/-/algoliasearch-5.21.0.tgz",
@@ -2051,6 +2089,13 @@
"sprintf-js": "~1.0.2"
}
},
+ "node_modules/asynckit": {
+ "version": "0.4.0",
+ "resolved": "https://registry.npmjs.org/asynckit/-/asynckit-0.4.0.tgz",
+ "integrity": "sha512-Oei9OH4tRh0YqU3GxhX79dM/mwVgvbZJaSNaRk+bshkj0S5cfHcgYakreBjrHwatXKbz+IoIdYLxrKim2MjW0Q==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/birpc": {
"version": "0.2.19",
"resolved": "https://registry.npmjs.org/birpc/-/birpc-0.2.19.tgz",
@@ -2074,6 +2119,20 @@
"node": ">=8"
}
},
+ "node_modules/call-bind-apply-helpers": {
+ "version": "1.0.2",
+ "resolved": "https://registry.npmjs.org/call-bind-apply-helpers/-/call-bind-apply-helpers-1.0.2.tgz",
+ "integrity": "sha512-Sp1ablJ0ivDkSzjcaJdxEunN5/XvksFJ2sMBFfq6x0ryhQV/2b/KwFe21cMpmHtPOSij8K99/wSfoEuTObmuMQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "es-errors": "^1.3.0",
+ "function-bind": "^1.1.2"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
"node_modules/ccount": {
"version": "2.0.1",
"resolved": "https://registry.npmjs.org/ccount/-/ccount-2.0.1.tgz",
@@ -2135,6 +2194,19 @@
"chevrotain": "^11.0.0"
}
},
+ "node_modules/combined-stream": {
+ "version": "1.0.8",
+ "resolved": "https://registry.npmjs.org/combined-stream/-/combined-stream-1.0.8.tgz",
+ "integrity": "sha512-FQN4MRfuJeHf7cBbBMJFXhKSDq+2kAArBlmRBvcvFE5BB1HZKXtSFASDhdlz9zOYwxh8lDdnvmMOe/+5cdoEdg==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "delayed-stream": "~1.0.0"
+ },
+ "engines": {
+ "node": ">= 0.8"
+ }
+ },
"node_modules/comma-separated-tokens": {
"version": "2.0.3",
"resolved": "https://registry.npmjs.org/comma-separated-tokens/-/comma-separated-tokens-2.0.3.tgz",
@@ -2772,6 +2844,16 @@
"robust-predicates": "^3.0.2"
}
},
+ "node_modules/delayed-stream": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/delayed-stream/-/delayed-stream-1.0.0.tgz",
+ "integrity": "sha512-ZySD7Nf91aLB0RxL4KGrKHBXl7Eds1DAmEdcoVawXnLD7SDhpNgtuII2aAkg7a7QS41jxPSZ17p4VdGnMHk3MQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=0.4.0"
+ }
+ },
"node_modules/dequal": {
"version": "2.0.3",
"resolved": "https://registry.npmjs.org/dequal/-/dequal-2.0.3.tgz",
@@ -2819,6 +2901,21 @@
"url": "https://dotenvx.com"
}
},
+ "node_modules/dunder-proto": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/dunder-proto/-/dunder-proto-1.0.1.tgz",
+ "integrity": "sha512-KIN/nDJBQRcXw0MLVhZE9iQHmG68qAVIBg9CqmUYjmQIhgij9U5MFvrqkUL5FbtyyzZuOeOt0zdeRe4UY7ct+A==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "call-bind-apply-helpers": "^1.0.1",
+ "es-errors": "^1.3.0",
+ "gopd": "^1.2.0"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
"node_modules/emoji-regex-xs": {
"version": "1.0.0",
"resolved": "https://registry.npmjs.org/emoji-regex-xs/-/emoji-regex-xs-1.0.0.tgz",
@@ -2839,6 +2936,55 @@
"url": "https://github.com/fb55/entities?sponsor=1"
}
},
+ "node_modules/es-define-property": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/es-define-property/-/es-define-property-1.0.1.tgz",
+ "integrity": "sha512-e3nRfgfUZ4rNGL232gUgX06QNyyez04KdjFrF+LTRoOXmrOgFKDg4BCdsjW8EnT69eqdYGmRpJwiPVYNrCaW3g==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/es-errors": {
+ "version": "1.3.0",
+ "resolved": "https://registry.npmjs.org/es-errors/-/es-errors-1.3.0.tgz",
+ "integrity": "sha512-Zf5H2Kxt2xjTvbJvP2ZWLEICxA6j+hAmMzIlypy4xcBg1vKVnx89Wy0GbS+kf5cwCVFFzdCFh2XSCFNULS6csw==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/es-object-atoms": {
+ "version": "1.1.1",
+ "resolved": "https://registry.npmjs.org/es-object-atoms/-/es-object-atoms-1.1.1.tgz",
+ "integrity": "sha512-FGgH2h8zKNim9ljj7dankFPcICIK9Cp5bm+c2gQSYePhpaG5+esrLODihIorn+Pe6FGJzWhXQotPv73jTaldXA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "es-errors": "^1.3.0"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
+ "node_modules/es-set-tostringtag": {
+ "version": "2.1.0",
+ "resolved": "https://registry.npmjs.org/es-set-tostringtag/-/es-set-tostringtag-2.1.0.tgz",
+ "integrity": "sha512-j6vWzfrGVfyXxge+O0x5sh6cvxAog0a/4Rdd2K36zCMV5eJ+/+tOAngRO8cODMNWbVRdVlmGZQL2YS3yR8bIUA==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "es-errors": "^1.3.0",
+ "get-intrinsic": "^1.2.6",
+ "has-tostringtag": "^1.0.2",
+ "hasown": "^2.0.2"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
"node_modules/esbuild": {
"version": "0.25.1",
"resolved": "https://registry.npmjs.org/esbuild/-/esbuild-0.25.1.tgz",
@@ -2902,6 +3048,16 @@
"dev": true,
"license": "MIT"
},
+ "node_modules/event-target-shim": {
+ "version": "5.0.1",
+ "resolved": "https://registry.npmjs.org/event-target-shim/-/event-target-shim-5.0.1.tgz",
+ "integrity": "sha512-i/2XbnSz/uxRCU6+NdVJgKWDTM427+MqYbkQzD321DuCQJUqOuJKIA0IM2+W2xtYHdKOmZ4dR6fExsd4SXL+WQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">=6"
+ }
+ },
"node_modules/exsolve": {
"version": "1.0.4",
"resolved": "https://registry.npmjs.org/exsolve/-/exsolve-1.0.4.tgz",
@@ -2972,6 +3128,43 @@
"tabbable": "^6.2.0"
}
},
+ "node_modules/form-data": {
+ "version": "4.0.2",
+ "resolved": "https://registry.npmjs.org/form-data/-/form-data-4.0.2.tgz",
+ "integrity": "sha512-hGfm/slu0ZabnNt4oaRZ6uREyfCj6P4fT/n6A1rGV+Z0VdGXjfOhVUpkn6qVQONHGIFwmveGXyDs75+nr6FM8w==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "asynckit": "^0.4.0",
+ "combined-stream": "^1.0.8",
+ "es-set-tostringtag": "^2.1.0",
+ "mime-types": "^2.1.12"
+ },
+ "engines": {
+ "node": ">= 6"
+ }
+ },
+ "node_modules/form-data-encoder": {
+ "version": "1.7.2",
+ "resolved": "https://registry.npmjs.org/form-data-encoder/-/form-data-encoder-1.7.2.tgz",
+ "integrity": "sha512-qfqtYan3rxrnCk1VYaA4H+Ms9xdpPqvLZa6xmMgFvhO32x7/3J/ExcTd6qpxM0vH2GdMI+poehyBZvqfMTto8A==",
+ "dev": true,
+ "license": "MIT"
+ },
+ "node_modules/formdata-node": {
+ "version": "4.4.1",
+ "resolved": "https://registry.npmjs.org/formdata-node/-/formdata-node-4.4.1.tgz",
+ "integrity": "sha512-0iirZp3uVDjVGt9p49aTaqjk84TrglENEDuqfdlZQ1roC9CWlPk6Avf8EEnZNcAqPonwkG35x4n3ww/1THYAeQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "node-domexception": "1.0.0",
+ "web-streams-polyfill": "4.0.0-beta.3"
+ },
+ "engines": {
+ "node": ">= 12.20"
+ }
+ },
"node_modules/fsevents": {
"version": "2.3.3",
"resolved": "https://registry.npmjs.org/fsevents/-/fsevents-2.3.3.tgz",
@@ -2987,6 +3180,55 @@
"node": "^8.16.0 || ^10.6.0 || >=11.0.0"
}
},
+ "node_modules/function-bind": {
+ "version": "1.1.2",
+ "resolved": "https://registry.npmjs.org/function-bind/-/function-bind-1.1.2.tgz",
+ "integrity": "sha512-7XHNxH7qX9xG5mIwxkhumTox/MIRNcOgDrxWsMt2pAr23WHp6MrRlN7FBSFpCpr+oVO0F744iUgR82nJMfG2SA==",
+ "dev": true,
+ "license": "MIT",
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/get-intrinsic": {
+ "version": "1.3.0",
+ "resolved": "https://registry.npmjs.org/get-intrinsic/-/get-intrinsic-1.3.0.tgz",
+ "integrity": "sha512-9fSjSaos/fRIVIp+xSJlE6lfwhES7LNtKaCBIamHsjr2na1BiABJPo0mOjjz8GJDURarmCPGqaiVg5mfjb98CQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "call-bind-apply-helpers": "^1.0.2",
+ "es-define-property": "^1.0.1",
+ "es-errors": "^1.3.0",
+ "es-object-atoms": "^1.1.1",
+ "function-bind": "^1.1.2",
+ "get-proto": "^1.0.1",
+ "gopd": "^1.2.0",
+ "has-symbols": "^1.1.0",
+ "hasown": "^2.0.2",
+ "math-intrinsics": "^1.1.0"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/get-proto": {
+ "version": "1.0.1",
+ "resolved": "https://registry.npmjs.org/get-proto/-/get-proto-1.0.1.tgz",
+ "integrity": "sha512-sTSfBjoXBp89JvIKIefqw7U2CCebsc74kiY6awiGogKtoSGbgjYE/G/+l9sF3MWFPNc9IcoOC4ODfKHfxFmp0g==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "dunder-proto": "^1.0.1",
+ "es-object-atoms": "^1.0.0"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
"node_modules/glob-parent": {
"version": "5.1.2",
"resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz",
@@ -3013,6 +3255,19 @@
"url": "https://github.com/sponsors/sindresorhus"
}
},
+ "node_modules/gopd": {
+ "version": "1.2.0",
+ "resolved": "https://registry.npmjs.org/gopd/-/gopd-1.2.0.tgz",
+ "integrity": "sha512-ZUKRh6/kUFoAiTAtTYPZJ3hw9wNxx+BIBOijnlG9PnrJsCcSjs1wyyD6vJpaYtgnzDrKYRSqf3OO6Rfa93xsRg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
"node_modules/gray-matter": {
"version": "4.0.3",
"resolved": "https://registry.npmjs.org/gray-matter/-/gray-matter-4.0.3.tgz",
@@ -3036,6 +3291,48 @@
"dev": true,
"license": "MIT"
},
+ "node_modules/has-symbols": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/has-symbols/-/has-symbols-1.1.0.tgz",
+ "integrity": "sha512-1cDNdwJ2Jaohmb3sg4OmKaMBwuC48sYni5HUw2DvsC8LjGTLK9h+eb1X6RyuOHe4hT0ULCW68iomhjUoKUqlPQ==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/has-tostringtag": {
+ "version": "1.0.2",
+ "resolved": "https://registry.npmjs.org/has-tostringtag/-/has-tostringtag-1.0.2.tgz",
+ "integrity": "sha512-NqADB8VjPFLM2V0VvHUewwwsw0ZWBaIdgo+ieHtK3hasLz4qeCRjYcqfB6AQrBggRKppKF8L52/VqdVsO47Dlw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "has-symbols": "^1.0.3"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ },
+ "funding": {
+ "url": "https://github.com/sponsors/ljharb"
+ }
+ },
+ "node_modules/hasown": {
+ "version": "2.0.2",
+ "resolved": "https://registry.npmjs.org/hasown/-/hasown-2.0.2.tgz",
+ "integrity": "sha512-0hJU9SCPvmMzIBdZFqNPXWa6dqh7WdH0cII9y+CyS8rG3nL48Bclra9HmKhVVUHyPWNH5Y7xDwAB7bfgSjkUMQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "function-bind": "^1.1.2"
+ },
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
"node_modules/hast-util-to-html": {
"version": "9.0.5",
"resolved": "https://registry.npmjs.org/hast-util-to-html/-/hast-util-to-html-9.0.5.tgz",
@@ -3092,6 +3389,16 @@
"url": "https://github.com/sponsors/wooorm"
}
},
+ "node_modules/humanize-ms": {
+ "version": "1.2.1",
+ "resolved": "https://registry.npmjs.org/humanize-ms/-/humanize-ms-1.2.1.tgz",
+ "integrity": "sha512-Fl70vYtsAFb/C06PTS9dZBo7ihau+Tu/DNCk/OyHhea07S+aeMWpFFkUaXRa8fI+ScZbEI8dfSxwY7gxZ9SAVQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "ms": "^2.0.0"
+ }
+ },
"node_modules/iconv-lite": {
"version": "0.6.3",
"resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.6.3.tgz",
@@ -3314,6 +3621,16 @@
"node": ">= 18"
}
},
+ "node_modules/math-intrinsics": {
+ "version": "1.1.0",
+ "resolved": "https://registry.npmjs.org/math-intrinsics/-/math-intrinsics-1.1.0.tgz",
+ "integrity": "sha512-/IXtbwEk5HTPyEwyKX6hGkYXxM9nbj64B+ilVJnC/R6B0pH5G4V3b0pVbL7DBj4tkhBAppbQUlf6F6Xl9LHu1g==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.4"
+ }
+ },
"node_modules/mdast-util-to-hast": {
"version": "13.2.0",
"resolved": "https://registry.npmjs.org/mdast-util-to-hast/-/mdast-util-to-hast-13.2.0.tgz",
@@ -3483,6 +3800,29 @@
"node": ">=8.6"
}
},
+ "node_modules/mime-db": {
+ "version": "1.52.0",
+ "resolved": "https://registry.npmjs.org/mime-db/-/mime-db-1.52.0.tgz",
+ "integrity": "sha512-sPU4uV7dYlvtWJxwwxHD0PuihVNiE7TyAbQ5SWxDCB9mUYvOgroQOwYQQOKPJ8CIbE+1ETVlOoK1UC2nU3gYvg==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
+ "node_modules/mime-types": {
+ "version": "2.1.35",
+ "resolved": "https://registry.npmjs.org/mime-types/-/mime-types-2.1.35.tgz",
+ "integrity": "sha512-ZDY+bPm5zTTF+YpCrAU9nK0UgICYPT0QtT1NZWFv4s++TNkcgVaT0g6+4R2uI4MjQjzysHB1zxuWL50hzaeXiw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "mime-db": "1.52.0"
+ },
+ "engines": {
+ "node": ">= 0.6"
+ }
+ },
"node_modules/minisearch": {
"version": "7.1.2",
"resolved": "https://registry.npmjs.org/minisearch/-/minisearch-7.1.2.tgz",
@@ -3555,6 +3895,47 @@
"node": "^10 || ^12 || ^13.7 || ^14 || >=15.0.1"
}
},
+ "node_modules/node-domexception": {
+ "version": "1.0.0",
+ "resolved": "https://registry.npmjs.org/node-domexception/-/node-domexception-1.0.0.tgz",
+ "integrity": "sha512-/jKZoMpw0F8GRwl4/eLROPA3cfcXtLApP0QzLmUT/HuPCZWyB7IY9ZrMeKw2O/nFIqPQB3PVM9aYm0F312AXDQ==",
+ "dev": true,
+ "funding": [
+ {
+ "type": "github",
+ "url": "https://github.com/sponsors/jimmywarting"
+ },
+ {
+ "type": "github",
+ "url": "https://paypal.me/jimmywarting"
+ }
+ ],
+ "license": "MIT",
+ "engines": {
+ "node": ">=10.5.0"
+ }
+ },
+ "node_modules/node-fetch": {
+ "version": "2.7.0",
+ "resolved": "https://registry.npmjs.org/node-fetch/-/node-fetch-2.7.0.tgz",
+ "integrity": "sha512-c4FRfUm/dbcWZ7U+1Wq0AwCyFL+3nt2bEw05wfxSz+DWpWsitgmSgYmy2dQdWyKC1694ELPqMs/YzUSNozLt8A==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "whatwg-url": "^5.0.0"
+ },
+ "engines": {
+ "node": "4.x || >=6.0.0"
+ },
+ "peerDependencies": {
+ "encoding": "^0.1.0"
+ },
+ "peerDependenciesMeta": {
+ "encoding": {
+ "optional": true
+ }
+ }
+ },
"node_modules/non-layered-tidy-tree-layout": {
"version": "2.0.2",
"resolved": "https://registry.npmjs.org/non-layered-tidy-tree-layout/-/non-layered-tidy-tree-layout-2.0.2.tgz",
@@ -3575,6 +3956,54 @@
"regex-recursion": "^6.0.2"
}
},
+ "node_modules/openai": {
+ "version": "4.87.4",
+ "resolved": "https://registry.npmjs.org/openai/-/openai-4.87.4.tgz",
+ "integrity": "sha512-lsfM20jZY4A0lNexfoUAkfmrEXxaTXvv8OKYicpeAJUNHObpRgkvC7pxPgMnB6gc9ID8OCwzzhEhBpNy69UR7w==",
+ "dev": true,
+ "license": "Apache-2.0",
+ "dependencies": {
+ "@types/node": "^18.11.18",
+ "@types/node-fetch": "^2.6.4",
+ "abort-controller": "^3.0.0",
+ "agentkeepalive": "^4.2.1",
+ "form-data-encoder": "1.7.2",
+ "formdata-node": "^4.3.2",
+ "node-fetch": "^2.6.7"
+ },
+ "bin": {
+ "openai": "bin/cli"
+ },
+ "peerDependencies": {
+ "ws": "^8.18.0",
+ "zod": "^3.23.8"
+ },
+ "peerDependenciesMeta": {
+ "ws": {
+ "optional": true
+ },
+ "zod": {
+ "optional": true
+ }
+ }
+ },
+ "node_modules/openai/node_modules/@types/node": {
+ "version": "18.19.80",
+ "resolved": "https://registry.npmjs.org/@types/node/-/node-18.19.80.tgz",
+ "integrity": "sha512-kEWeMwMeIvxYkeg1gTc01awpwLbfMRZXdIhwRcakd/KlK53jmRC26LqcbIt7fnAQTu5GzlnWmzA3H6+l1u6xxQ==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "undici-types": "~5.26.4"
+ }
+ },
+ "node_modules/openai/node_modules/undici-types": {
+ "version": "5.26.5",
+ "resolved": "https://registry.npmjs.org/undici-types/-/undici-types-5.26.5.tgz",
+ "integrity": "sha512-JlCMO+ehdEIKqlFxk6IfVoAUVmgz7cU7zD/h9XZ0qzeosSHmUJVOzSQvvYSYWXkFXC+IfLKSIffhv0sVZup6pA==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/package-manager-detector": {
"version": "0.2.11",
"resolved": "https://registry.npmjs.org/package-manager-detector/-/package-manager-detector-0.2.11.tgz",
@@ -4036,6 +4465,13 @@
"node": ">=8.0"
}
},
+ "node_modules/tr46": {
+ "version": "0.0.3",
+ "resolved": "https://registry.npmjs.org/tr46/-/tr46-0.0.3.tgz",
+ "integrity": "sha512-N3WMsuqV66lT30CrXNbEjx4GEwlow3v6rr4mCcv6prnfwhS01rkgyFdjPNBYd9br7LpXV1+Emh01fHnq2Gdgrw==",
+ "dev": true,
+ "license": "MIT"
+ },
"node_modules/trim-lines": {
"version": "3.0.1",
"resolved": "https://registry.npmjs.org/trim-lines/-/trim-lines-3.0.1.tgz",
@@ -4884,6 +5320,34 @@
}
}
},
+ "node_modules/web-streams-polyfill": {
+ "version": "4.0.0-beta.3",
+ "resolved": "https://registry.npmjs.org/web-streams-polyfill/-/web-streams-polyfill-4.0.0-beta.3.tgz",
+ "integrity": "sha512-QW95TCTaHmsYfHDybGMwO5IJIM93I/6vTRk+daHTWFPhwh+C8Cg7j7XyKrwrj8Ib6vYXe0ocYNrmzY4xAAN6ug==",
+ "dev": true,
+ "license": "MIT",
+ "engines": {
+ "node": ">= 14"
+ }
+ },
+ "node_modules/webidl-conversions": {
+ "version": "3.0.1",
+ "resolved": "https://registry.npmjs.org/webidl-conversions/-/webidl-conversions-3.0.1.tgz",
+ "integrity": "sha512-2JAn3z8AR6rjK8Sm8orRC0h/bcl/DqL7tRPdGZ4I1CjdF+EaMLmYxBHyXuKL849eucPFhvBoxMsflfOb8kxaeQ==",
+ "dev": true,
+ "license": "BSD-2-Clause"
+ },
+ "node_modules/whatwg-url": {
+ "version": "5.0.0",
+ "resolved": "https://registry.npmjs.org/whatwg-url/-/whatwg-url-5.0.0.tgz",
+ "integrity": "sha512-saE57nupxk6v3HY35+jzBwYa0rKSy0XR8JSxZPwgLr7ys0IBzhGviA1/TUGJLmSVqs8pb9AnvICXEuOHLprYTw==",
+ "dev": true,
+ "license": "MIT",
+ "dependencies": {
+ "tr46": "~0.0.3",
+ "webidl-conversions": "^3.0.0"
+ }
+ },
"node_modules/zwitch": {
"version": "2.0.4",
"resolved": "https://registry.npmjs.org/zwitch/-/zwitch-2.0.4.tgz",
diff --git a/package.json b/package.json
index 1594e28a..c70e9876 100644
--- a/package.json
+++ b/package.json
@@ -19,6 +19,7 @@
"gray-matter": "^4.0.3",
"marked": "^15.0.7",
"mermaid": "^11.5.0",
+ "openai": "^4.87.4",
"vitepress": "^1.6.3",
"vitepress-plugin-mermaid": "^2.0.17",
"vue": "^3.5.13"
diff --git a/scripts/ai-translate.mjs b/scripts/ai-translate.mjs
new file mode 100644
index 00000000..4741656e
--- /dev/null
+++ b/scripts/ai-translate.mjs
@@ -0,0 +1,238 @@
+import fs from 'fs/promises';
+import path from 'path';
+import dotenv from 'dotenv';
+import OpenAI from 'openai';
+import { fileURLToPath } from 'url';
+import { createInterface } from 'readline';
+
+// 加载环境变量
+dotenv.config();
+
+// 检查环境变量是否存在
+const requiredEnvVars = ['OPENAI_API_KEY', 'OPENAI_BASE_URL', 'OPENAI_MODEL'];
+const missingEnvVars = requiredEnvVars.filter(varName => !process.env[varName]);
+
+if (missingEnvVars.length > 0) {
+ console.error(`❌ 缺少必要的环境变量: ${missingEnvVars.join(', ')}`);
+ console.error('请在.env文件中设置这些变量');
+ process.exit(1);
+}
+
+// 初始化OpenAI客户端
+const openai = new OpenAI({
+ apiKey: process.env.OPENAI_API_KEY,
+ baseURL: process.env.OPENAI_BASE_URL
+});
+
+const model = process.env.OPENAI_MODEL || 'gpt-4-turbo';
+
+// 获取命令行参数（相对路径）
+const args = process.argv.slice(2);
+
+if (args.length !== 1) {
+ console.error('❌ 请提供要翻译的目录的相对路径');
+ console.error('用法: node ai-translate.mjs <目录相对路径>');
+ process.exit(1);
+}
+
+// 获取脚本所在目录的绝对路径
+const scriptDir = path.dirname(fileURLToPath(import.meta.url));
+// 计算目标目录的绝对路径
+const targetDir = path.resolve(scriptDir, '..', args[0]);
+
+async function findMarkdownFiles(dir) {
+ const files = [];
+
+ // 检测文本是否包含中文的函数
+ function containsChinese(text) {
+ // 匹配中文字符的正则表达式
+ const chineseRegex = /[\u4e00-\u9fa5]/;
+ return chineseRegex.test(text);
+ }
+
+ async function traverse(currentDir) {
+ const entries = await fs.readdir(currentDir, { withFileTypes: true });
+
+ for (const entry of entries) {
+ const fullPath = path.join(currentDir, entry.name);
+
+ if (entry.isDirectory()) {
+ await traverse(fullPath);
+ } else if (entry.isFile() && entry.name.endsWith('.md')) {
+ try {
+ // 读取文件内容
+ const content = await fs.readFile(fullPath, 'utf-8');
+
+ // 如果文件不包含中文，则添加到待翻译列表
+ if (!containsChinese(content)) {
+ files.push(fullPath);
+ } else {
+ console.log(`⏭️ 跳过已包含中文的文件: ${path.relative(targetDir, fullPath)}`);
+ }
+ } catch (error) {
+ console.error(`❌ 读取文件 ${fullPath} 时出错:`, error.message);
+ }
+ }
+ }
+ }
+
+ await traverse(dir);
+ return files;
+}
+async function translateMarkdown(filePath) {
+ try {
+ console.log(`🔄 正在处理文件: ${path.relative(targetDir, filePath)}`);
+
+ // 读取Markdown内容
+ const content = await fs.readFile(filePath, 'utf-8');
+
+ // 创建翻译提示
+ const prompt = `你是一位专业的Minecraft基岩版文档翻译者，需要结合给出的原始英文文档，准确翻译为简体中文，保留所有的vitepress特性和组件。在翻译时，尽量保证概念传达的准确性，但是同时需要满足中文母语者的生活自然语序和语法和词语，阅读时需要尽量轻松和容易。
+翻译要求：
+- 包括头部的matter yml内容，也需要对应翻译。
+- 在开头根据matter yml的title字段，添加h1大标题（如果没有的话就不用添加）
+- 不需要翻译代码，但是需要翻译代码块中的注释。
+- 部分在开发时遇到的专有词汇，需要考虑是否需要保留英文原文。比如：Tick、Component、Entity、Block、Item等
+- 组件需要被替换为另一种表达形式，使用::: code-group :::包裹（别忘了末尾的:::），例子：
+::: code-group
+\`\`\`json [原始CodeHeader的值]
+xxx
+\`\`\`
+:::
+
+以下为待翻译内容：
+${content}`;
+
+ console.log(`🧠 开始翻译，请耐心等待...`);
+
+ // 使用OpenAI API进行流式翻译
+ const stream = await openai.chat.completions.create({
+ model: model,
+ messages: [
+ {
+ role: "system",
+ content: "你是一个专业的Markdown文档翻译助手，能够准确地将英文Markdown内容翻译成简体中文，同时保持原有格式和结构。"
+ },
+ {
+ role: "user",
+ content: prompt
+ }
+ ],
+ stream: true,
+ max_tokens: 8 * 1024,
+ response_format: { type: "text" },
+ });
+
+ let translatedContent = '';
+ let reasoningContent = '';
+
+ for await (const chunk of stream) {
+ // 提取思考过程和内容（如果有的话）
+ const reasoning = chunk.choices[0]?.delta?.reasoning_content || '';
+ const content = chunk.choices[0]?.delta?.content || '';
+
+ if (reasoning) {
+ process.stdout.write(reasoning);
+ reasoningContent += reasoning;
+ }
+
+ if (content) {
+ process.stdout.write(content);
+ translatedContent += content;
+ }
+ }
+
+ // 将翻译后的内容写入文件
+ await fs.writeFile(filePath, translatedContent.trim(), 'utf-8');
+ console.log(`\n✅ 文件翻译完成: ${path.relative(targetDir, filePath)}`);
+
+ return true;
+ } catch (error) {
+ console.error(`\n❌ 翻译 ${path.relative(targetDir, filePath)} 时出错:`);
+ console.error(error.message);
+ return false;
+ }
+}
+
+async function promptForConfirmation(message) {
+ const rl = createInterface({
+ input: process.stdin,
+ output: process.stdout
+ });
+
+ return new Promise(resolve => {
+ rl.question(message, answer => {
+ rl.close();
+ resolve(answer.toLowerCase() === 'y' || answer.toLowerCase() === 'yes');
+ });
+ });
+}
+
+async function main() {
+ try {
+ console.log(`🔍 正在扫描目录: ${targetDir}`);
+
+ // 检查目录是否存在
+ try {
+ await fs.access(targetDir);
+ } catch (error) {
+ console.error(`❌ 指定的目录不存在: ${targetDir}`);
+ process.exit(1);
+ }
+
+ // 查找所有Markdown文件
+ const markdownFiles = await findMarkdownFiles(targetDir);
+
+ if (markdownFiles.length === 0) {
+ console.log(`⚠️ 在 ${targetDir} 中没有找到Markdown文件`);
+ process.exit(0);
+ }
+
+ console.log(`🔎 找到 ${markdownFiles.length} 个Markdown文件`);
+ markdownFiles.forEach((file, index) => {
+ console.log(` ${index + 1}. ${path.relative(targetDir, file)}`);
+ });
+
+ // 请求确认
+ const confirmed = await promptForConfirmation(`⚠️ 此操作将翻译并覆盖以上文件。确认继续吗? (y/n): `);
+
+ if (!confirmed) {
+ console.log('❌ 操作已取消');
+ process.exit(0);
+ }
+
+ console.log('🚀 开始翻译...');
+
+ // 逐个翻译文件
+ let successful = 0;
+ let failed = 0;
+
+ for (let i = 0; i < markdownFiles.length; i++) {
+ const file = markdownFiles[i];
+ console.log(`\n[${i + 1}/${markdownFiles.length}] 处理文件: ${path.relative(targetDir, file)}`);
+
+ const success = await translateMarkdown(file);
+
+ if (success) {
+ successful++;
+ } else {
+ failed++;
+ }
+ }
+
+ console.log('\n📊 翻译统计:');
+ console.log(`✅ 成功: ${successful} 个文件`);
+ console.log(`❌ 失败: ${failed} 个文件`);
+
+ if (failed > 0) {
+ process.exit(1);
+ }
+ } catch (error) {
+ console.error('❌ 发生错误:');
+ console.error(error);
+ process.exit(1);
+ }
+}
+
+// 通过node指令手动执行，因为需要带参数：node scripts/ai-translate.mjs <目录相对路径>
+main();
\ No newline at end of file
diff --git a/scripts/sidebar.ts b/scripts/sidebar.ts
index f98751fe..95bcfadb 100644
--- a/scripts/sidebar.ts
+++ b/scripts/sidebar.ts
@@ -1,6 +1,7 @@
import fs from 'fs/promises';
import path from 'path';
import fg from 'fast-glob';
+import matter from 'gray-matter'
// 定义侧边栏项目接口
interface SidebarItem {
@@ -34,9 +35,16 @@ const CATEGORY_MAP: Record = {
* 从名称中提取排序数字
* 例如：'0-概述' 返回 0，'1-基础' 返回 1
*/
-function extractOrderNumber(name: string): number {
+function extractOrderNumber(name: string, matterData: any): number {
const match = name.match(/^(\d+)-/);
- return match ? parseInt(match[1], 10) : Number.MAX_SAFE_INTEGER; // 没有数字前缀的排在最后
+ if (match) {
+ return parseInt(match[1], 10);
+ } else if (matterData.order) {
+ return parseInt(matterData.order);
+ } else if (matterData.nav_order) {
+ return parseInt(matterData.nav_order);
+ }
+ return Number.MAX_SAFE_INTEGER;
}
/**
@@ -54,6 +62,14 @@ async function generateSidebar(): Promise> {
const segments = relativePath.split(path.sep);
const categoryKey = segments[0];
+ // 读取文件内容，然后通过matter读取头部信息
+ const fileContent = await fs.readFile(filePath, 'utf-8');
+ const { data: matterData } = matter(fileContent);
+
+ if (matterData.hidden) {
+ continue;
+ }
+
// 使用映射表获取显示名称
const categoryName = CATEGORY_MAP[categoryKey] || categoryKey;
@@ -77,11 +93,11 @@ async function generateSidebar(): Promise> {
link = `/${segment}`;
}
- const order = extractOrderNumber(segment); // 提取排序号
+ const order = extractOrderNumber(segment, matterData); // 提取排序号
if (isLast) {
// 添加最终文件项
- const title = await getTitleFromFile(filePath);
+ const title = await getTitleFromFile(filePath, matterData);
// 添加 activeMatch 以支持更精确的高亮匹配
const activeMatch = `^${link}(?:/|$)`;
currentLevel.push({ text: title, link, order, activeMatch });
@@ -158,25 +174,14 @@ function sortSidebarItems(items: SidebarItem[]): void {
/**
* 从文件 Frontmatter 或文件名提取标题
*/
-async function getTitleFromFile(filePath: string): Promise {
- try {
- const content = await fs.readFile(filePath, 'utf-8');
- // 寻找 title 在 frontmatter 中的位置
- const frontmatterMatch = content.match(/^---\s*[\s\S]*?title:\s*(.*?)[\r\n][\s\S]*?---/);
-
- if (frontmatterMatch && frontmatterMatch[1]) {
- // 清理标题（移除引号等）
- return frontmatterMatch[1].trim().replace(/['"]/g, '');
- }
-
- // 如果没有 frontmatter title，从文件名获取
- const basename = path.basename(filePath, '.md');
- // 普通文件，移除数字前缀和连字符
- return basename.replace(/^\d+-\s*/, '').replace(/-/g, ' ');
- } catch (error) {
- console.error(`读取文件失败: ${filePath}`, error);
- return path.basename(filePath, '.md');
+async function getTitleFromFile(filePath: string, matterData: any): Promise {
+ if (matterData.title) {
+ return matterData.title.trim().replace(/['"]/g, '');
}
+ // 如果没有 frontmatter title，从文件名获取
+ const basename = path.basename(filePath, '.md');
+ // 普通文件，移除数字前缀和连字符
+ return basename.replace(/^\d+-\s*/, '').replace(/-/g, ' ');
}
export default generateSidebar;