Overview#
Lucraft Core serves as the foundational engine for a suite of superhero mods, including Iron Man, Ant-Man, and Speedster Heroes. Beyond acting as a dependency, it introduces a standardized system for superpowers, a karma mechanic, and a variety of high-tech materials. It provides the necessary API for ability management, suit construction, and energy handling, making it an essential component for any modded environment focused on superhuman abilities.
Materials and Resources#
The mod adds several new ores and metals that are required for crafting advanced technology and superhero equipment. These materials are found throughout the overworld at various depths.
Ores and Ingots
| Material | Mining Level | Spawn Height | Description |
|---|---|---|---|
| Titanium | Iron (2) | 0 - 40 | A lightweight, durable metal used for basic suit components and machinery. |
| Vibranium | Diamond (3) | 0 - 20 | An extremely rare and powerful metal capable of absorbing kinetic energy. |
| Palladium | Iron (2) | 0 - 30 | Primarily used in the construction of Arc Reactors and energy cells. |
| Iridium | Diamond (3) | 0 - 15 | A dense metal used for high-tier technological upgrades. |
| Uranium | Iron (2) | 0 - 50 | A radioactive material used for power generation and inducing mutations. |
Base Materials
- Suit Fabric: Crafted using wool and string, this is the base component for most superhero costumes.
- Circuit Boards: Used in the assembly of advanced electronics and suit HUDs.
Superpower System#
The core feature of the mod is the Superpower System. Powers are not just items but are bound to the player's entity data.
Acquiring Powers
Players can obtain powers through several methods:
- Injections: Using a Syringe filled with specific serums (e.g., Super Soldier Serum).
- Radiation: Exposure to Gamma Radiation or other environmental hazards (often added by sub-mods).
- Items: Some powers are granted by wearing specific items or suits.
Ability Bar
Once a power is acquired, players can access their abilities via the Ability Bar. By default, pressing N opens the ability selection menu. Abilities can be toggled on or off, and some require a cooldown or energy cost.
Leveling and XP
Superpowers can be leveled up through use. As a player uses their abilities, they gain Power XP. Higher levels unlock new sub-abilities, increase damage, or reduce energy consumption.
Karma System#
The Karma system tracks the player's moral alignment based on their actions in the world.
- Good Karma: Earned by killing hostile mobs, protecting villagers, and defeating 'villain' players.
- Bad Karma: Earned by killing passive mobs, attacking villagers, or harming 'hero' players.
Karma affects how certain NPCs interact with the player and can influence the effectiveness of specific superpowers. Some abilities may only be available to players with a specific alignment (e.g., Heroic or Villainous).
Key Blocks and Machinery#
Lucraft Core introduces several utility blocks necessary for processing materials and managing powers.
Suit Fabricator
The primary workstation for creating superhero suits. It features a unique 3D interface where players can place different components (Head, Torso, Legs, Feet) and apply various materials to customize stats.
Extraction Bench
Used to extract DNA or chemical compounds from items. This is essential for creating power serums and researching new abilities.
Construction Table
A specialized crafting table used for assembling complex technological components that do not fit in a standard 3x3 grid.
| Block | Function |
|---|---|
| Suit Fabricator | Crafting and customizing superhero armor sets. |
| Extraction Bench | Extracting serums and biological data. |
| Construction Table | Advanced multi-component crafting. |
| Induction Furnace | High-speed smelting of mod-specific ores. |
Instruction System#
To help players navigate the complex systems, the mod includes an Instruction Book system. These books provide step-by-step guides on how to build specific machines or how to utilize certain powers.
- Instruction Book: Can be crafted with a book and a piece of Titanium.
- Data Chips: Can be inserted into the book to unlock new chapters regarding specific superheroes or technologies.
Commands#
Administrators can manage the mod's systems using the following commands:
/superpower <player> get <power>: Grants a specific superpower to a player./superpower <player> remove: Removes all superpowers from a player./karma <player> add/set <amount>: Modifies a player's karma level./lucraftcore xp <player> add <amount>: Adds experience points to a player's current superpower.
Configuration#
The mod offers extensive configuration options via the lucraftcore.cfg file. Server owners can adjust:
- Ore Generation: Toggle the spawning of Titanium, Vibranium, etc.
- Ability Settings: Adjust global cooldowns and energy costs.
- Karma Impact: Define how much karma is gained or lost for specific actions.
- Render Settings: Toggle the visibility of the Ability Bar and other HUD elements.
