Powerworks

For players

Offchunk website · Report an issue · Development status

Development prototype — no public download yet. Do not install a source archive as a mod.

Include your mod, Minecraft and loader versions, what happened and how to reproduce it. For setup questions or private logs, use Offchunk Help; do not post passwords or access tokens in public issues.

Samostatný Minecraft mod pro výrobu, rozvod, ukládání a využití elektřiny.

Veřejný název na Modrinthu: Powerworks. Autor/značka: Offchunk.

Zdrojový kód · Úkoly a chyby · Milníky

Vývojový postup a hranice ověřování: CONTRIBUTING.md.

Vývojový prototyp 0.1.0-dev.22 navazuje na první samostatnou dílnu z dev.21: drtička používá dva železné ingoty místo dvou bloků a kniha receptů vede od mědi přes generátor a motor k drtičce. Celá dílna s baterií a měřákem stojí 36 železa, 10 mědi a 14 redstonu plus vanilla součásti. Nápovědy předmětů vysvětlují přípojky a spotřebu; Shift-klik s blokem na generátoru umožní stavění. Dev.22 rozděluje nápovědy generátoru, kabelu, motoru, drtičky a baterie do krátkých řádků v češtině i angličtině po zachyceném ořezu při velkém GUI. Materiály a postup. Serverové ověření dev.21 prošlo na všech třech verzích: 1 194 kontrol craftingu a dílny plus 327 standalone regresních kontrol. Serverové testy začínají dodanými materiály po tavení; agent pak dokončil nativní průchod 26.2 od dodaných surových rud přes výrobu až po drcení pouze z baterie. Finální dev.22 přidává 327 nových standalone kontrol na všech třech verzích. Osobní hráčské přijetí má samostatný rozsah. Celý survival úkol #7 zůstává otevřený; přesný rozsah.

Dev.20 zachovává náboj stacionární baterie při survival vytěžení a opětovném položení. Nabitý kus se nestohuje; tooltip ukazuje náboj i kapacitu 8 192 E. Nabíjecí stojan nově používá v receptu měděný blok místo baterie. Jde o první část survival úkolu #7, nikoli dokončený survival postup. Pravidla přemístění baterie a stav ověření. Serverové ověření dev.20 zahrnuje baterii a standalone na všech třech verzích a EV regresi s Automobility .36 na 26.2 bez Momentum/P&P. Hráč přijal přemístění baterie se zachováním náboje na 26.2; přesný rozsah a zbývající sestavy uvádí QA.md.

Dev.19 sjednotil elektrický pohon s volitelným Momentum: Powerworks účtuje trakci a rekuperaci, Momentum dodává nastavení jízdy a brzdy. Společná sestava vyžaduje přesné kandidátní verze s novým API; tabulka kompatibility a pravidla. Bez Momentum zůstává přijatá mírnější brzda dev.18 (0,03 za tick). Dev.19 také opravuje kopírování nabité baterie při opakovaném položení auta v creative. Dev.17 přidal napájení přímých spotřebičů z auta přes ruční kabel: Shift + pravý klik prázdnou hlavní rukou přepíná stojan mezi nabíjením a výdejem. Výdej má limit 32 E/t a ponechává 20 % baterie na odjezd. Při brzdění S z jízdy vpřed auto zastaví; zpátečka vyžaduje puštění a nový stisk S. Od dev.16 má rekuperaci při skutečném zpomalování: mírnou po puštění plynu, rychlejší při brzdění, omezenou zaplacenou energií. Zachovává současný dojezd. Od dev.15 propojuje elektromotor s volitelnou palivovou politikou P&P: přesná identita powerworks:electric odmítá kapalné palivo a pohon spotřebovává pouze energii baterie. Tato kombinace vyžaduje P&P core i Automobility addon 1.10.4-dev.8.pw1 a Automobility .36 na 26.1.2 nebo 26.2. Zachovává delší dojezd po puštění plynu, opravené modely, vlastní zvuk elektromotoru a ruční připojení kabelu: vezmi konektor ze stojanu a klikni na zaparkovaný elektromobil. Pohon účtuje energii z uložené trakční baterie a řidič vidí potvrzený náboj i návrat energie. Ovládání a hranice integrace.

Hráčsky přijatá základna 0.1.0-dev.8 přidala stacionární elektrický motor a drtičku. Obsahuje uhelný generátor LV a generátor na kapalná paliva HV s volitelným adaptérem Pumps & Pistons. Navazuje na tři velikosti větrných turbín, solární pole a stojany, sezónní faktor, LV/HV vedení, transformátory, odpojovače, měřák, baterii a elektrickou lampu. Dev.7 sjednocuje vzhled ostatních strojů, solárů, větrníků a rozvodů podle přijatého kotle dev.6, který zůstává beze změny. Motor odebírá 8 E/t a přímo pohání drtičku: dlažební kostka → štěrk → písek, 100 napájených tiků na jeden krok. Pravidla a ukázková dílna. Velké elektrárny jsou další práce. Jde o vývojový prototyp, nikoli veřejnou alpha verzi. Stav ověření a známá omezení jsou v QA.md. Výtvarná pravidla a generování modelů popisuje docs/ART.md.

Rozhodnutý rozsah

• Powerworks funguje bez Pumps & Pistons i bez Automobility.
• Pumps & Pistons volitelně dodává ropu, benzín a naftu. Nový adaptér používá společné kapalné API a rezervace P&P; přesné podporované sestavy uvádí QA.md.
• Volitelný adaptér Automobility .36 přidává pohon, ukládání baterie a nabíjení. Přesné verze a hranice testů uvádí QA.md.
• Serene Seasons může měnit solární výkon podle svého kalendáře. Adaptér je v dev.3 implementovaný; stav jeho runtime ověření uvádí QA.md.
• Cílové verze: Minecraft Java 26.1.2, 26.2 a 26.3; Fabric podle současné rodiny modů.
• Elektřina, elektrárny a motory patří do jednoho produktu Powerworks.

Celý postup a návrh větrných/solárních elektráren, napětí a integrací: ROADMAP.md. Původní zadání: PROJECT.md.

Build

Použij JDK 25 a Python 3.11+. Společný model je v core/, herní kód a assets v shared/, verzové buildy v versions/. Gradle wrapper je součástí projektu.

.\tools\Build-Powerworks.ps1 -JavaHome 'C:\cesta\k\jdk-25'

Pomocník nejprve připraví připnutá API volitelných integrací, vygeneruje assets a spustí Gradle. Modely a textury ověří až po vytvoření Minecraft cache Loomem. Příprava API neinstaluje volitelné mody hráči. Serverové QA pomocníky nyní používají Windows; skutečný čistý build a Forgejo CI jsou samostatné otevřené úkoly.

Tři výsledné soubory jsou v versions/<Minecraft verze>/build/libs/, vždy powerworks-0.1.0-dev.22+<Minecraft verze>-fabric.jar. Použij jen JAR odpovídající verzi hry a matching Fabric API. Zdrojové JARy do mods nepatří.

Vývojový klient například pro 26.2:

$env:JAVA_HOME = 'C:\cesta\k\jdk-25'
.\gradlew.bat :fabric-26_2:runClient

Uživatel přijal větrnou ukázku dev.4 v klientu 26.2 a vzhled kotle dev.6 dne 2026-09-30. Ukázku dev.7 následně obecně přijal slovy „ok super“; tím nejsou jednotlivě potvrzené všechny vizuální ani funkční scénáře. Oddělené QA světy, přesný rozsah přijetí a výsledky testů sleduje QA.md. Veřejné vydání a ověření ostatních grafických klientů i multiplayeru zbývají. Ukázku dev.8 uživatel následně obecně přijal slovy „Ano super ok“. Navazující integrační plán je v docs/development/ELECTRIC-VEHICLES.md.

První zkouška ve hře

1. Použij nový zkušební svět. V kreativní záložce Powerworks najdeš dvacet bloků a měřák. Pro survival dílnu získání mědi ukáže generátor, LV kabel a měřák; redstone ukáže baterii, generátor motor a motor drtičku. Kniha tím napovídá pořadí, ruční výrobu novou podmínkou neomezuje.
2. Připoj panel, lampu a baterii ze tří stran ke stejnému LV kabelu podle schématu níže. Panel musí mít oblohu nad sebou. Další ploché panely mohou navazovat přímo vedle něj; vedení pod každým panelem není potřeba.
3. Přes den lampa svítí a přebytek nabíjí baterii. Měřákem klikni na blok pro výrobu, odběr, přenos a ztrátu z posledního ticku. Prázdná ruka na baterii ukáže náboj.
4. V noci lampa čerpá z baterie, po vybití zhasne. Přeruš kabel pro oddělení částí sítě.
5. Ulož a znovu otevři svět: baterie na místě zachová náboj. Od dev.20 jej také předá itemu při běžném survival vytěžení a zpět bloku při položení. Pro přesné porovnání ji nejprve odpoj od sítě, aby se mezitím nenabíjela ani nevybíjela. Nabitý kus má limit jeden; prázdné baterie se skládají po 64.

Panel — LV kabel — Lampa
            |
         Baterie

Baterie a lampy jsou koncové stroje: nepřenášejí elektřinu skrz sebe k dalším blokům a baterie mezi sebou nepřelévají náboj. Každý solár má od dev.3 navíc průchozí LV sběrnici. Sítě propojují také kabely, uzavřené odpojovače a správně otočené transformátory.

Solární pole

Ploché panely spojuj ve stejné výšce po stranách. Vnější rám zůstává na obvodu pole, sousední vnitřní okraje zmizí. Stojany solar_panel_rack mají sklon 22,5° a spojují se pouze vedle sebe ve stejně orientované řadě. Jejich facing označuje nízkou přední hranu; při položení míří od hráče. Plochý panel a stojan se přímo nespojí, stejně tak stojany s jinou orientací nebo za sebou.

Každý panel má maximum 16 E/t a společnou průchozí sběrnici omezenou na 32 E/t. Delší řada připojená jediným koncem proto nepřenese neomezený součet všech panelů; větší pole potřebuje více vhodně rozmístěných odběrných přípojek. LV kabel či stroj můžeš připojit z boku nebo zdola, nikoli shora. Zakrytý panel nevyrábí, ale dál vede energii sousedů. Stojan stojí jeden panel, dva železné ingoty a tři měděné ingoty.

Výroba plynule sleduje denní dobu, přístup k obloze a intenzitu počasí. V poledne bez sezónní redukce dává panel 16 E/t za jasna, 7 E/t při plném dešti a 3 E/t při plném dešti s bouřkou. Přechody počasí jsou postupné; v noci je výroba nulová. Směrové zastínění ani směr slunce vůči sklonu stojanu se zatím nepočítají.

Volitelný Serene Seasons adaptér používá jeho kalendář: v kotevních bodech poloviny jara/podzimu faktor 0,85, léta 1,00 a zimy 0,65, mezi nimi plynulý přechod. Déšť se počítá pouze jednou. Bez modu, v tropických nebo vyloučených biomech a dimenzích je faktor 1,00. Měřák na soláru doplní denní světlo, oblohu, déšť, bouřku, sezónu a výsledný faktor. Připnuté sestavy s adaptérem prošly i regresí dev.4 na všech třech cílových verzích; přesný rozsah uvádí QA.md.

Větrné turbíny

Postav wind_turbine_base, nad něj souvislý sloupec wind_turbine_tower a nahoru gondolu. Malá/střední/velká turbína potřebuje výšku náboje nejméně 8/16/24 bloků nad základem, tedy 7/15/23 segmentů. Stožár lze prodloužit nejvýše na 48 bloků. Rotory mají poloměr 3/5/7 bloků a výkony nejvýše 32/128/512 E/t.

Náboj leží jeden blok před gondolou ve směru facing. Nech volný celý kruhový disk rotoru i jeden blok rezervy: kontrolovaný poloměr je 4/6/8 bloků. Překážka, mezera ve stožáru nebo nenačtený potřebný chunk zastaví výrobu. Rotor má setrvačnost; dobíhání po zastavení není další zdroj energie.

Elektřinu odebírej HV kabelem ze základu, z boku nebo zdola. Pro LV baterii a lampu přidej snižovací transformátor. Jediný LV kabel zůstává omezený na 32 E/t. Měřák na gondole či základu ukáže stav a odběr. Pravý klik na gondolu s oběma rukama prázdnýma přepne servisní brzdu; za silného větru nebo bouřky pracuje ochrana.

Postup stavby, recepty, provozní pravidla a testovací příkazy jsou v docs/WIND.md. Serverová matice má PASS pro všechny tři cíle a klientská zkouška 26.2 má PASS v omezeném rozsahu. Uživatel přijal původní ukázku dev.4 dne 2026-09-30 a později obecně přijal ukázku dev.7. Přesné důkazy a zbývající mezery uvádí QA.md.

Uhlí a kapalná paliva

Uhelný generátor dodává nejvýše 32 E/t LV, kapalinový 128 E/t HV. Kabel připoj vždy zezadu, proti směru předního čela. U uhlí otevře Shift + pravý klik prázdnou rukou nebo neblokovým předmětem pět slotů; měřák zůstává diagnostikou a Shift s blokem v ruce dovolí stavět. Uhlí i dřevěné uhlí poskytují 32 000 E za kus, blok uhlí 288 000 E. Běžný pravý klik generátor vypne nebo zapne; u kapalinového měj obě ruce prázdné. Bez elektrického odběru se palivo nespaluje; zbytek načaté jednotky přežije restart.

Kapalinová nádrž pojme 8 000 ml. P&P adaptér používá jeho vlastní palivové API: kanystrem se běžným klikem plní, se Shiftem odebírá; automaticky může čerpat nejvýše 100 ml/tick z jednoho přímo sousedícího podporovaného stroje P&P. V ruce musí být právě jeden kanystr, včetně prázdného; celý stack se odmítne. Surová ropa / benzín / nafta poskytují 4 / 8 / 12 E za ml. Starší cesta cílí na P&P 1.10.3 a místní 1.10.4-rc.1 pro 26.1.2 a 26.2. Dev.14 přidává samostatnou cestu pro přesné P&P 1.10.4-dev.8 a dev.15 také pro 1.10.4-dev.8.pw1 na těchto dvou verzích: sousední zásobní nádrž a přečerpávací hadice používají společné P&P rozhraní a rezervace přenosu. Automatický odběr plánuje celé kroky po 10 ml; menší zbytek zůstává ve zdroji. Kanystr na generátoru má nadále výše popsané ovládání jedním kliknutím. Aktuální rozsah ověření je v QA.md. 26.3 funguje bez této integrace. Fabric Fluid API se nepoužívá. Kapalinový generátor lze vyrobit bez P&P, pak hlásí nedostupná paliva a nevyrábí.

Postup, podporované sousední stroje a omezení při vytěžení popisuje docs/COMBUSTION.md. Nový místní svět lze připravit pomocníkem tools/prepare_client_world.py --showcase combustion; funkce powerworks_qa:combustion_showcase staví uhelný okruh a prázdný kapalinový okruh, powerworks_qa:combustion_view mění jen kameru. Aktuální ověření sleduje QA.md.

LV a HV rozvody

Pro přenos přes HV postav například:

Panel → LV kabel → Zvyšující trafo → HV vedení → Snižující trafo → LV kabel → Lampa

Šipka na transformátoru ukazuje výstup; vstup je na opačné straně, boční strany nevedou. Při položení výstup míří směrem od hráče. Shift + kliknutí s oběma rukama prázdnýma jej otočí doprava. Na odpojovač klikni prázdnou rukou pro rozpojení/spojení. Měřák blok pouze měří, nepřepíná jej. LV a HV kabely se přímým dotykem nespojí.

Od dev.7 model i kolizní obrys kabelu sledují skutečné přípojky podle napětí a směru portů sousedních strojů. U otevřeného odpojovače kabel zůstává fyzicky připojený; průchod elektřiny přeruší jeho zvednutý kontakt. Měřák má vlastní ruční 3D model; nakreslená ručička je součást vzhledu, hodnoty se dál čtou kliknutím.

Prvek	Limit přenosu	Ztrátová váha
LV kabel / odpojovač	32 E/t	kabel 5 ‰ za blok; odpojovač 0
HV kabel / odpojovač	512 E/t	kabel 1 ‰ za blok; odpojovač 0
Transformátor	256 E/t na vstupu	50 ‰ za převod
Baterie	64 E/t; kapacita 8192 E	0
Sběrnice jednoho soláru	32 E/t; vlastní výroba nejvýše 16 E/t	0
Základ větrné turbíny	HV výstup nejvýše 512 E/t; podle gondoly a větru	0
Uhelný / kapalinový generátor	zadní výstup LV 32 / HV 128 E/t	0

Ztrátové váhy se na trase sčítají; výsledný výstup se zaokrouhluje dolů na celé E. U malých odběrů je proto skutečná procentní ztráta vyšší. Limity všech průchozích prvků se sdílejí mezi odběrateli; přetížení omezí přenos bez exploze. Podrobnosti: docs/DISTRIBUTION.md.

Dev.8 přidává stacionární motor s drtičkou. Elektromobil má vlastní baterii, zvuk a ručně připojovaný kabel pro nabíjení i výdej, omezenou rekuperaci a rezervu pro odjezd. Velké elektrárny zůstávají dalším milníkem; rozsah ověření sleduje QA.md.