Game Phases is a Fabric alternative to Game Stages by Darkhax. It supports the idea of separating the game into "phases," each of which unlocks new content. Each phase has a prerequisite, and until that phase is unlocked, all content inside it will be unusable.
Game Phases relies on KubeJS for configuration and setup. All Game Phase scripts are in server_scripts.
For more information on setting up Game Phases, visit the wiki page.
Due to Game Phases being a 'modpack-mod' (one that users would not normally install on their own), it does not include/JIJ dependencies with it. You will have to install these separately:
- Illusion by Draylar
- KubeJS by shedaniel & Latvian
- Rhino by Latvian
- Architectury by shedaniel
Game Phases has built-in compatibility with the following mods:
- Roughly Enough Items by shedaniel
- Restricted items are hidden from the item view
Define a phase:
onEvent('gamephases.initialize', event => {
event.phase('one');
});Grant the phase to the user when they obtain stone:
{
"parent": "minecraft:recipes/root",
"rewards": {
"phase": [
"one"
]
},
"criteria": {
"has_cobblestone": {
"trigger": "minecraft:inventory_changed",
"conditions": {
"items": [
{
"items": [
"minecraft:cobblestone"
]
}
]
}
}
},
"requirements": [
[
"has_cobblestone"
]
]
}Grant a phase through the /phase command:
/phase grant Draylar one
Game Phases allows you to restrict access to items based on phases. As a general overview, each phase can blacklist specific items. If a player does not meet the requirements for any phase that blacklists a given item, they will not be able to use it.
General blacklist restrictions include:
- Blocked out item tooltip
- Unable to use (right-click) the item
- Prevent item pickups
- Cancel any recipes involving the item
- Drop when equipped
- Invisible in REI and creative inventory [NYI]
onEvent('gamephases.initialize', event => {
// Lock Iron Ingot & all entries under the mymod namespace under phase one
event.phase('one');
.item('minecraft:iron_ingot')
.item('mymod:*');
});Block Restrictions are similar to Item Restrictions. Illusion is used to restrict the visibility of hidden blocks, and additional tweaks are implemented to make the hidden block as non-visible as possible.
General blacklist restrictions include:
- Full visibility change through Illusion
- Altered break drops
The following example hides Diamond Ore as stone.
onEvent('gamephases.initialize', event => {
// Replace stone with Diamond Ore
event.phase('one');
.block('minecraft:diamond_ore', 'minecraft:stone');
});You can prevent access to dimensions through dimension restrictions.
General dimension restrictions include:
- Any teleport to this dimension will be cancelled.
onEvent('gamephases.initialize', event => {
// Lock Nether Entry behind 'one'
event.phase('one')
.dimension('minecraft:the_nether');
});You can prevent mob spawns through entity restrictions. When a mob attempts to spawn naturally, it will check phase restrictions. If any phase restricts the mob and no nearby players have passed the phase, the spawn will fail.
By default, mob spawns check for players 128 blocks out from their position. By lowering this counter, you can prevent spawns near the player based on phase, while still allowing the mob to spawn further out, regardless of the current phase.
onEvent('gamephases.initialize', event => {
// Prevent creepers from spawning around players that have not passed phase one
event.phase('one')
.entity('minecraft:creeper');
});Game Phases exposes several utility methods you can use with KubeJS to depend on phases.
Here is an example script which prints an extra message to the player if they have the one game phase:
Note: phases are synced S2C, which allows for client-side KubeJS scripts that depend on phases.
onEvent('player.chat', event => {
var hasOne = event.player.hasPhase('one');
// If the player has unlocked the 'one' rank, print an extra message.
if(hasOne) {
event.player.tell('You are powerful.')
}
});Game Phases is available under MIT.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent