What is Conium

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

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

Requirements

Requirement	Version	Installs	Notes
Java	21!!	Need	Only 21 can be use
Minecraft	1.21.4!!	Need	Only 1.21.4 can be use
Fabric language kotlin	1.13.1+kotlin.2.1.10!!	Need	Only kotlin 2.1.10 can be use
Fabric API	?	Need	Any version is ok
Fluxia	1.1.4-fix3!!	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!!	Only 21 can be use
Gradle	8.11	8.11 or other could be use
Kotlin	2.1.10!!	Only 2.1.10 can be use
Fabric loom	1.9.2	1.9.2 or other could be use
Minecraft	1.21.4!!	Only 1.21.4 can be use

NeoForge

About support 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 runs the sample.

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.