新世代を呼ぶハロー、声はまだ途切れないだろう、
新世界の扉を、ほら叩き続けよう！
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.
The full Conium feature is currently as 'on client' mode, the server needs to synchronize the datapacks and scripts to client but are not completed this feature now.
But the Conium scripting system can run on the server side completely, only the bedrock scripting APIs are not available on the server side now.
| Requirement | Version | Installs | Notes |
|---|---|---|---|
| Java | 21+ | 21 Or higher | 21 Or higher is ok |
| Minecraft | >=1.21.11 | Need | 1.21.11 or higher can be use |
| Fabric language kotlin | 1.13.5+kotlin.2.2.10!! | Need | Only kotlin 2.2.10 can be use |
| Fabric API | ? | Need | Any version is ok |
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.10!! | Only 2.2.10 can be use |
| Fabric loom | 1.13-SNAPSHOT | 1.13-SNAPSHOT or other could be use |
| Minecraft | >=1.21.11 | Only 1.21.11 or higher can be use |
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.
You can join ours discord server to chat with Conium community！
- <path-to-save>/datapacks
- <pack-name>
- data
- <pack-name>
- item
- This directory is items, data type is '.json'
- block
- This directory is blocks, data type is '.json'
- entity
- This directory is entities, data type is '.json'
- property
- item
- This directory is item properties injectors, data type is '.json'
- block
- This directory is block properties injectors, data type is '.json'
- item
- script
- This directory is scripts, data type is 'kts', '.ts' and '.js' (js is not usable yet)
- item
- <pack-name>
- data
- <pack-name>
For conium templates, see Conium data driven.
For bedrock components, see Bedrock data driven.
{
// If using conium schema, 'schema' is required.
"schema_style": "conium",
// The identifier must present.
"identifier": "awa:conium",
"templates": {
// The components where here following listed.
}
}Example:
{
"schema_style": "conium",
"identifier": "awa:conium",
"templates": {
"tool": {
// The damage amount when hitting the entity.
"attack_damage": 100,
// The cooldown modifier after once attack.
"attack_speed": -3.0,
// The durability amount.
"durability": 50,
// Which blocks this tool can mine.
// This value is a tag key.
"effective_blocks": "minecraft:mineable/pickaxe",
// This tool is what material.
"is_weapon": false,
// This tool is the weapon or not.
// The durability will decrement 2 after this tool damage to entity when it not weapon.
"material": "netherite"
},
// Setting this tool item can destroy blocks in creative mode.
"can_destroy_in_creative": true,
// The max item stack size.
// The size value must in range 1 to 64.
"max_count": 64
}
}{
// If using bedrock schema, 'schema' can be missing.
"schema_style": "bedrock",
// Format version always can be missing, conium is supporting to the schemas by all versions.
"format_version": "1.20.10",
"minecraft:item": {
// Description and identifier must present.
"description": {
"identifier": "awa:bedrock"
},
"components": {
// The components where here following listed.
}
}
}For further information, see the Data driven
Conium supported to run the kotlin script in game running, called as 'Conium script.'
Directly write and put the '.kts' file to /saves/<world>/datapacks/<pack-name>/data/<pack-name>/script.
Conium script can handle game events used to complete what you need.
Use request to subscribe an event, first parameter is the type of event, for all events, see Event types.
Then other parameters are the context args, for all args type, see Context arg types.
// Shorter schema.
request(
PLACED_BLOCK,
BLOCK_POS
) { _, pos ->
// Do something here.
// Here must return a boolean.
// True means this event is succeed, false then means failures.
true
}
// Full schema.
// The 'arise' call be shorter as missing in 'request', but 'presage' cannot.
request(
PLACED_BLOCK,
BLOCK_POS
).arise { _, pos ->
// Do something here.
// Here must return a boolean.
// True means this event is succeed, false then means failures.
true
}// Shorter schema.
preRequest(
PLACED_BLOCK,
BLOCK_POS
) { _, pos ->
// Here must return a boolean.
// The presaging is called before the event really happening,
// the whole event will be canceled when the result is false.
// (whole mean the event after events, like 'PLACED_BLOCK' is the after event of 'PLACE_BLOCK')
true
}For further information, see the Conium scripting.
Not completed bedrock script APIs supports now, only framework able to run the samples.
About TypeScript grammar, supported by structuring-translator: TypeScript supports
The MoLang support also based on structuring-translator but implemented by Conium: MoLang supports
Conium is built on an event-driven, context-oriented architecture with strong aspect-like capabilities, though it does not use event-sourced state semantics.
The codebase is architecturally complex and extensive. While we continuously improve documentation, navigating the source may still be challenging.
Therefore, we strongly recommend discussing your ideas with the core team before contributing. This ensures alignment with the project’s design and specifications.
Please note that pull requests submitted without prior discussion may be declined. For general inquiries, we encourage you to submit an issue tagged “question.”
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.