Skip to content

Codex Reference Configuration

CaptainGummiball edited this page Nov 10, 2026 · 1 revision

Configuration

QNet has one server configuration with every game rule of the mod, and a small client configuration for the looks. This page lists every setting with its default and its allowed range.

Where the files are

  • config/qnet-server.properties is the template. Every new world copies it on its first start.
  • <world>/serverconfig/qnet-server.properties is the world's own copy. From its first start on, a world reads only this file. On a dedicated server this is the file to edit; in single player each world keeps its own settings.
  • config/qnet-client.properties holds the client settings (looks only).

How the server files behave:

  • They are read when the server starts. Change them while the server is stopped; a change takes effect at the next start.
  • QNet writes both server files back with every key and its comment, so new settings appear by themselves after an update.
  • A value outside its range, or one that cannot be read, falls back to its default and is reported in the log. Before such a file is rewritten, your text is kept as .bak.
  • A key no section knows is reported in the log. Keys that moved to another section keep their value (for example volt.safeMode became safety.safeMode).
  • The configuration files of the older mods QuantaVolt, QuantaWorks and QuantaRift are taken over once and kept as .bak.
  • The server sends its settings to every player who joins, so windows and switched-off features look the same for everyone.

general

Settings several parts of QNet use.

  • general.linkRange (default 96, allowed 16–512): the longest distance of every Quanta Linker connection (Rift structures and displays from the gate controller, storage members from their controller), in blocks.
  • general.teamMaxMembers (default 16, allowed 0–256): team members per player.

volt (energy)

  • volt.basicDynamoOutput (default 40, allowed 1–100000): energy per tick of a burning Basic Dynamo (E/t).
  • volt.stirlingMaxOutput (default 100, allowed 1–100000): the largest electrical output of a Stirling Generator (E/t).
  • volt.solarModuleOutput (default 6, allowed 1–10000): energy per tick of one PV module in full sun (E/t).
  • volt.heliostatHeat (default 8, allowed 1–10000): heat per tick of one heliostat in full direct sun (HU/t).
  • volt.windPowerFactor (default 10.0, allowed 0.01–1000.0): the factor K in the wind turbine power: K × rotor area × wind³ × Cp (E/t).
  • volt.generatorOutputMultiplier (default 1.0, allowed 0.01–100.0): multiplies the output of every generator and turbine.
  • volt.fuelConsumptionMultiplier (default 1.0, allowed 0.01–100.0): multiplies the fuel use (higher = fuel lasts shorter).
  • volt.advancedReactorModel (default false): the advanced model for fission reactors: power with a period, prompt criticality, xenon, a positive void effect and columns (where rods, fuel and moderators stand matters). Off keeps the standard model.
  • volt.maxFissionReactorSize (default 15, allowed 5–32): the largest edge of a fission reactor.
  • volt.fusionStartupEnergy (default 800000000, allowed 1000–100000000000): energy a tokamak needs to reach ignition (E).
  • volt.littleStarIgnitionEnergy (default 2000000000, allowed 1000–1000000000000): energy a Little Star needs to ignite (E).
  • volt.singularityIgnitionEnergy (default 10000000000, allowed 1000–10000000000000): energy a Micro Black Hole Plant needs to form its singularity (E).
  • volt.energyPerMassUnit (default 10000000, allowed 1000–1000000000000): energy of one mass unit (one compressed matter) in the singularity technology (E).
  • volt.batteryCellCapacity (default 8000000, allowed 1000–1000000000): energy one battery cell of a Battery Hall stores (E).
  • volt.smesCoilCapacity (default 50000000, allowed 1000–100000000000): energy one superconducting coil of an SMES stores (E).
  • volt.gravityEnergyPerWeightBlock (default 20000, allowed 100–10000000): energy a gravity store holds per weight and block of lift height (E).
  • volt.dimensionCapacity (default 1000000000000000, allowed 1000000–4000000000000000000): capacity of a dimensional store (E).
  • volt.dimensionOpenEnergy (default 50000000000, allowed 1000–10000000000000): energy that opens the pocket of a dimensional store (E).
  • volt.maxCapacitorModules (default 128, allowed 1–1024): the most capacitor modules one capacitor bank collects.
  • volt.maxSolarModules (default 256, allowed 1–4096): the most PV modules one solar array collects.
  • volt.maxHeliostats (default 512, allowed 1–4096): the most heliostats one Solar Receiver collects.
  • volt.maxWindBladeLength (default 8, allowed 2–16): the longest rotor arm of a wind turbine, in blocks.
  • volt.minWindTowerHeight (default 4, allowed 1–64): the fewest tower segments (ports included) below a wind turbine nacelle.

works (processing)

  • works.fallbackRecipes (default true): makes the recycling recipes (ingot, gem, plate and so on back to dust) for materials that have none of their own.
  • works.legacyMaterialTags (default true): also reads old-style material tags such as c:iron_ingots, only where the form c:ingots/iron is missing.
  • works.preferredNamespaces (default minecraft,qnet, allowed comma-separated names): which mod's item a machine makes when several mods make the same material form. The first name in the list wins; otherwise the smallest id.
  • works.strictBalance (default false): also switches off data pack recipes that make material from nothing in a loop. QNet's own derived recipes are always checked.
  • works.assemblerBlockedRecipes (default , allowed comma-separated ids): crafting recipe ids the Assembler must not automate, in addition to the lists of data packs (qnet/not_automatable).
  • works.deepCoreEnergyPerOre (default 20000000, allowed 1000000–2000000000): energy the Deep Core Extractor needs for one ore block. More energy never brings up more ore.
  • works.deepCoreRegionReserve (default 50000, allowed 100–100000000): ore blocks one region of 128 × 128 blocks holds for Deep Core Extractors; every ore costs 1 + mined ÷ reserve times the energy.
  • works.projectorEntities (default false): shows build projections as block displays that every player sees, instead of ghost blocks for players holding a Build Projector. See Tools.

storage

  • storage.interfaceView (default 64, allowed 1–256): the most entries a Storage Interface shows to pipes and other mods (filter places and resolved patterns).
  • storage.externalScanPerInterface (default 64, allowed 1–4096): slots or tanks one External Storage Interface reads per tick at most.
  • storage.externalScanTotal (default 512, allowed 1–65536): slots or tanks all External Storage Interfaces of a dimension read per tick together at most.

logic

  • logic.gridMonitorLinks (default 64, allowed 1–256): the most blocks one Grid Monitor watches (each is read once a second).
  • logic.machineInterfaceItems (default 64, allowed 1–4096): items a Machine Interface moves per tick and direction at most.
  • logic.machineInterfaceMb (default 1000, allowed 1–64000): fluid or gas in mB a Machine Interface moves per tick and direction at most.
  • logic.factoryJobs (default 8, allowed 1–64): jobs one Factory Controller runs at the same time at most (one job = one recipe step at one machine).
  • logic.factoryEnergyBase (default 32, allowed 0–100000): energy a Factory Controller draws per tick (E/t).
  • logic.factoryEnergyPerJob (default 8, allowed 0–100000): extra energy per tick for each running job (E/t).
  • logic.factoryStockSeconds (default 10, allowed 1–300): seconds between two checks of a Factory Controller's stock targets.

features

Switches for whole parts of QNet, for integrations and for single blocks.

  • features.volt (default true), features.works (default true), features.rift (default true), features.storage (default true), features.logic (default true): each switches a module with all of its blocks.
  • features.disabled (default , allowed comma-separated ids): single machines and plants to switch off, as block ids separated by commas, for example qnet:fission_controller, qnet:crusher.
  • Integrations, each only while the other mod is installed: features.integration.ae2 (default true), features.integration.computercraft (default true), features.integration.create (default true), features.integration.mekanism (default true), features.integration.ftbteams (default true), features.integration.ftbchunks (default true), features.integration.openpartiesandclaims (default true) and features.integration.permissions (default true). See Other Mods. The recipe viewers and Jade run on each player's computer and have no switch here.

What "switched off" means:

  • Nothing is removed. The blocks stay in the world and keep their contents.
  • They are frozen: they do not run, offer nothing to pipes and other mods, and their windows accept nothing. You can still open them, take everything out and mine them.
  • Their windows show the red line "Disabled by the server" at the top, and their items say "Switched off on this server" in the tooltip.
  • They cannot be crafted, and their machine recipes are gone.
  • Only blocks that do something are switched off (machines, controllers, storage, logic and Rift blocks); casings, ores and decorative blocks never are.
  • The ports and Energy Input Hatches belong to no module, like the casings: every module's plants use them. They stay on whatever you switch off; only the ports of a plant whose controller is switched off are closed with it.

safety

  • safety.safeMode (default false): only overheating and an immediate shutdown: no explosions, no damage to entities or blocks, no radiation.
  • safety.terrainDamage (default false): whether severe incidents (bursts, meltdowns, breaches) destroy blocks. Only without safe mode, and never in claimed land.
  • safety.fire (default true): whether a thermal runaway sets fire (only together with terrain damage).
  • safety.incidentPowerScale (default 1.0, allowed 0.0–4.0): scales the blast power and reach of severe incidents.
  • safety.entityDamageScale (default 1.0, allowed 0.0–4.0): scales the damage incidents do to players and mobs (explosions, flashes, shock waves; 0 = none).

radiation

  • radiation.enabled (default true): radiation of running nuclear plants, of meltdowns and radiation flashes and of carried waste: damage over time to living beings nearby. Lead blocks and the radiation suit protect. Always off in safe mode.
  • radiation.reachScale (default 1.0, allowed 0.25–2.0): scales how far radiation reaches.
  • radiation.strengthScale (default 1.0, allowed 0.0–4.0): scales the damage radiation does (0 = none; Geiger Counters still measure the unscaled field).

terrain

  • terrain.fieldMachines (default true): whether the Farming Station and the Tree Harvester may change the world. Off, they stand still; they never work in foreign claims.
  • terrain.fieldInterval (default 10, allowed 1–200): ticks between two actions of a field machine (one position per action).
  • terrain.fieldRadius (default 4, allowed 1–6): the area of the Farming Station: 2 × radius + 1 blocks square in front of it (4 = 9 × 9).
  • terrain.naturalGasDimensions (default minecraft:overworld, allowed comma-separated ids): dimensions with natural gas fields, as ids separated by commas; empty = none.
  • terrain.naturalGasSmallFieldChance (default 0.32, allowed 0.0–1.0): share of the regions of 128 × 128 blocks with a small gas field.
  • terrain.naturalGasLargeFieldChance (default 0.08, allowed 0.0–1.0): share of the regions with a large gas field (small and large together at most 1).
  • terrain.naturalGasFieldSizeMultiplier (default 1.0, allowed 0.01–100.0): multiplies the content of gas fields.
  • terrain.naturalGasFieldRateMultiplier (default 1.0, allowed 0.01–100.0): multiplies the highest extraction rate of gas fields (small 120 mB/t, large 480 mB/t).

perf (performance)

  • perf.maxStructureSize (default 16, allowed 5–32): the longest edge of any plant outside the Rift (also the Warehouse). It bounds the work of checking a structure.
  • perf.multiblockAuditPerTick (default 8, allowed 1–64): block positions a formed plant checks per tick for foreign blocks in its open spaces. Fewer means less work, but a block placed inside is noticed later.
  • perf.menuSyncScale (default 1, allowed 1–4): multiplies the time between two updates of an open window (1 = normal; higher = less network traffic, slower windows).

rift

The Rift has the largest section. Energies are in FE, durations in ticks.

Structure and network:

  • rift.structure.gateDiameter (default 21, allowed 21–31): diameter of the Rift Gate ring in blocks, an odd number.
  • rift.structure.validationBudgetPerTick (default 256, allowed 16–8192): structure cells checked per controller and tick.
  • rift.network.actionsPerSecond (default 10, allowed 1–100): console actions accepted per player and second.
  • rift.network.snapshotIntervalTicks (default 10, allowed 2–100): how often open consoles get a new live picture (in ticks).

Energy and timing of the rift:

  • rift.energy.capacity (default 200000000): energy buffer of a complex.
  • rift.energy.portMaxInputPerTick (default 4000000): the most energy one energy port of the Rift accepts per tick.
  • rift.energy.calibration (default 4000000) and rift.time.calibrationTicks (default 200, allowed 1–72000): energy and duration of the calibration.
  • rift.energy.dial (default 12000000) and rift.time.dialTicks (default 100, allowed 1–72000): energy (times the difficulty of the address) and duration of opening a rift.
  • rift.energy.onlineUpkeepPerTick (default 20000): energy per tick while the rift is open, times the difficulty of the address.
  • rift.time.stabilizeTicks (default 120, allowed 1–72000): duration of the stabilisation ramp.
  • rift.time.shutdownTicks (default 40, allowed 1–72000): duration of a controlled shutdown.
  • rift.stability.required (default 0.65, allowed 0.0–1.0): the lowest field stability that keeps the rift open (as a share).

Research:

  • rift.research.timeScale (default 1.0, allowed 0.01–10.0): factor on the duration of every research project.
  • rift.research.blindScanEnergy (default 2000000) and rift.research.blindScanTicks (default 400, allowed 1–72000): a blind scan.
  • rift.research.initialUncertainty (default 48, allowed 2–4096): the uncertainty radius of a fresh signal from a blind scan.
  • rift.research.refineEnergy (default 1000000) and rift.research.refineTicks (default 300, allowed 1–72000): one triangulation.
  • rift.research.probeEnergy (default 8000000) and rift.research.probeTicks (default 600, allowed 1–72000): a focused probe (coordinate synthesis); its energy is multiplied by the difficulty of the address.
  • rift.research.sectorEnergy (default 10000000) and rift.research.sectorTicks (default 1200, allowed 1–72000): an automated sector sweep; rift.research.sectorRadius (default 48, allowed 4–1024) is its search radius on each axis, rift.research.sectorSignals (default 3, allowed 1–8) the most signals it finds.
  • rift.research.spectralEnergy (default 5000000) and rift.research.spectralTicks (default 600, allowed 1–72000): a spectral search; rift.research.spectralCandidates (default 96, allowed 1–4096) is the number of addresses it examines.
  • rift.research.surveyTicks (default 600, allowed 1–720000): ticks the rift must be open at an address until its deposits are surveyed.
  • rift.research.analyzeTicks (default 1800, allowed 1–720000): ticks the rift must be open at an address until its reserves are analysed.

Extraction:

  • rift.extraction.maxJobs (default 3, allowed 1–16): parallel extraction jobs per complex.
  • rift.program.maxEntries (default 8, allowed 1–32): addresses one job program holds at most.
  • rift.extraction.itemEnergyPerUnit (default 12000), rift.extraction.fluidEnergyPerMb (default 40), rift.extraction.gasEnergyPerMb (default 60): energy per extracted item, per mB of fluid and per mB of gas.
  • rift.extraction.maxRateFactor (default 4.0, allowed 0.25–16.0): the highest rate factor a job may ask for.
  • rift.extraction.rateEnergyExponent (default 1.35, allowed 1.0–3.0): energy per unit grows with rate^(exponent − 1).
  • rift.extraction.sectorBudget (default 100000): units (an item or a bucket each) a sector of 64 × 64 × 64 addresses gives; beyond that its jobs run at 1 ÷ (1 + extracted ÷ budget).
  • rift.extraction.sliceTicks (default 10, allowed 1–200): extraction is worked out every so many ticks.
  • rift.buffer.items (default 4096), rift.buffer.fluidMb (default 512000), rift.buffer.gasMb (default 512000): the buffers of the Matter Receiving Facility for items, fluids (mB) and gases (mB).

The client file

config/qnet-client.properties changes only what you see, never a game rule. It is read once when the game starts.

  • particleDensity (default 1.0, 0.0 to 4.0): multiplies the particles of machines, plants, turbines, reactors and the tokamak; 0 switches them off.
  • incidentEffects (default true): incident effects and warning signs at plants (steam, sparks, smoke, frost).
  • interiorEffects (default true): the life inside plants behind sight glass (embers, glow, steam, sparks, glints, frost).
  • flowEffects (default true): what leaves machines and plants (vapour, exhaust plumes, smoke, dust).
  • scene.mode (default AUTO): the live scene of the Rift console: AUTO (3D, falls back to 2.5D if needed), FULL_3D or FLAT_2_5D.
  • scene.quality (default HIGH): detail of the Rift console scene: LOW, MEDIUM or HIGH.

QNet Codex

Getting Started

Energy

Processing

Rift

Storage

Logic

Reference

Items and Blocks

Clone this wiki locally