What is Conium

新世代を呼ぶハロー、声はまだ途切れないだろう、
新世界の扉を、ほら叩き続けよう！

Conium is a datapack and script framework for modern Minecraft, it provides very diverse features without Java coding, Conium lets you complete your mods only using the datapacks.

Warning

Conium is currently as 'on client' mode, the server needs to synchronize the datapacks and scripts to client but are not completed this feature now.

Requirements

Requirement	Version	Installs	Notes
Java	21+	21 Or higher	21 Or higher is ok
Minecraft	>=1.21.6	Need	1.21.6 or higher can be use
Fabric language kotlin	1.13.4+kotlin.2.2.0!!	Need	Only kotlin 2.2.0 can be use
Fabric API	?	Need	Any version is ok
Fluxia	1.1.4-fix4!!	Unnecessary	Built-in contents translator

Build requirements

Conium has configured whole project, just clone the repository, and reload project then run the gradle task remapJar.

Requirement	Version	Notes
Java	21+	21 Or higher
Gradle	8.14.2	8.14.2 or higher could be use
Kotlin	2.2.0!!	Only 2.2.0 can be use
Fabric loom	1.10-SNAPSHOT	1.10-SNAPSHOT or other could be use
Minecraft	>=1.21.6	Only 1.21.6 or higher can be use

NeoForge

About supporting of NeoForge, currently cannot be completed because the secure jar handler in NeoForge has conflict to kotlin native.

And Conium cannot remove kotlin native because scripting running needs, Conium may try to run script evaluator without NeoForge environment in the future.

Discord server

You can join ours discord server to chat with Conium community！

Data driven

See the Data driven

Conium script APIs

See the Conium scripting.

Bedrock script APIs

Not completed bedrock script APIs supports now, only framework able to run the samples.

Grammars

About typescript grammar, supported by structring-translator or called fluxia: Typescript supports

APIs

Currently, there APIs are available:

In context:

Name	Conium API type	Gametest API type	Status
system	AbstractBedrockSystem	System	Alpha (Unstable)
world	AbstractBedrockWorld	World	Alpha (Unstable)

In APIs:

• world
  • AbstractBedrockWorld impl by BedrockWorld as known as 'World' in SAPI
    • player
      • BedrockPlayer as known as 'Player' in SAPI
        • delegate
          • BedrockPlayerDelegate as known as 'Player[]' in SAPI
        • screen
          • BedrockOnScreenDisplay as known as 'ScreenDisplay' in SAPI
  • dimension
    • BedrockDimensionLocation as known as 'DimensionLocation' in SAPI
• system
  • AbstractBedrockSystem impl by BedrockSystem as known as 'System' in SAPI
• item
  • stack
    • BedrockItemStack as known as 'ItemStack' in SAPI
• script
  • BedrockScriptAnonymousObjectMap as known as 'anonymous object' in Javascript
• event
  • BedrockBeforeEvents as known as 'WorldBeforeEvents' in SAPI
    • context
      • BedrockEventContext
      • item
        • use
          • BedrockItemUseOnEventContext as known as 'ItemUseOnBeforeEvent' and 'ItemUseOnAfterEvent' in SAPI
  • item
    • use
      • BedrockItemUseOnBeforeEvent as known as 'ItemUseOnBeforeEventSignal' in SAPI

By bedrock script APIs:

• world
  • fun getPlayers(): BedrockPlayerDelegate
    • operator fun get: BedrockPlayer(index: Int)
  • val onScreenDisplay: BedrockOnScreenDisplay
    • fun setTitle(title: String, properties: BedrockScriptAnonymousObjectMap)
    • fun updateSubtitle(title: String)
  • val eventsBefore = get(): BedrockBeforeEvents
    • val itemUseOn: BedrockItemUseOnEvent
      • fun subscribe(action: (BedrockItemUseOnEventContext) -> Unit)
• system
  • fun runInterval(callback: () -> Unit, tickInterval: Int): IntegerReceptacle
  • fun clearRun(runId: IntegerReceptacle)

Source code and commit

Conium has large and complex source codes and architectures.
Read source codes still very challenging even though we are completing documents and comments try we best.

So if you are willing to contribute to Conium, please do conversations with Conium developers to learn the details and specifications.
We will reject all pull requests that not after discussion.

If it is not necessary, avoid directly reading source codes.

Hitokoto

Conium will randomly roll a Hitokoto in console every time launching, the list of Hitokotos receives pull requests, only allow in English and Japanese, don't take other languages, don't accept nonsense sentences.

For the list, see ConiumHitokoto.kt.

Chinese wiki

The Hyacinth wiki.