0.6.1: tutorial on real chain networks, energy scene

- selling and buying scenes use Create's own frogport schematic and move an addressed package along
  the chains with the same calls as Create's scenes (guarded: without the classes they still show the network)
- new scene: selling energy to the state through a metered stressometer (also on create:stressometer)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

index.toml

@@ -814,7 +814,7 @@ hash = "db4c4a8ab49265f6e8e456f495800ea148b133b18a3242aabca30b98ab7f784f"
 
 [[files]]
 file = "kubejs/client_scripts/createrp_ponder.js"
-hash = "193c9f8b283e32f85504f8b198869d80f6ba1647924884a7f0db7de5eb8c6b47"
+hash = "4a6ebdddb0249b1f59fd0d3b67649df682b81c10ff60a65a9739c0fb8c4de6ac"
 
 [[files]]
 file = "kubejs/startup_scripts/createrp_items.js"

kubejs/client_scripts/createrp_ponder.js

@@ -1,16 +1,91 @@
 // Create RP — туторіал у стилі Create (Ponder): наведи на предмет і затисни W.
 // Потрібні PonderJS (мод «Ponder for KubeJS») і startup_scripts/createrp_items.js (предмет kubejs:citizen_guide).
-// Сцени будуються на стандартній плиті 5x5: y=0 — плита, блоки з y=1. Текст: _слово_ — підсвітка, як у Create.
+// Більшість сцен — на стандартній плиті 5x5 (y=0 — плита, блоки з y=1); продаж і покупки — на схематиці Create з ланцюгами. Текст: _слово_ — підсвітка, як у Create.
 
 const PACKAGE = 'create:cardboard_package_10x12'
 
-// посилка «летить» від однієї пакужаби до іншої: лінія маршруту + предмет-посилка
+// Справжні посилки на ланцюгах — тими ж викликами, що й у сценах самого Create (FrogAndConveyorScenes).
-function sendPackage(scene, from, to, ticks) {
+// Якщо KubeJS не дасть доступу до класів — сцени все одно покажуть мережу й текст, лише без руху посилок.
-  scene.overlay.showBigLine(PonderPalette.OUTPUT, from, to, ticks)
+let CreateScene = null, Frogport = null, ChainConveyor = null, PackageItem = null, PackageStyles = null
-  const dx = (to[0] - from[0]) / ticks, dy = 0.22, dz = (to[2] - from[2]) / ticks
+try {
-  const box = scene.world.createItemEntity(from, [dx, dy, dz], PACKAGE)
+  CreateScene = Java.loadClass('com.simibubi.create.foundation.ponder.CreateSceneBuilder')
-  scene.idle(ticks)
+  Frogport = Java.loadClass('com.simibubi.create.content.logistics.packagePort.frogport.FrogportBlockEntity')
-  scene.world.removeEntity(box)
+  ChainConveyor = Java.loadClass('com.simibubi.create.content.kinetics.chainConveyor.ChainConveyorBlockEntity')
+  PackageItem = Java.loadClass('com.simibubi.create.content.logistics.box.PackageItem')
+  PackageStyles = Java.loadClass('com.simibubi.create.content.logistics.box.PackageStyles')
+} catch (e) {
+  console.warn('[createrp] Create classes unavailable for Ponder animations: ' + e)
+}
+
+// посилка з адресою їде ланцюгами від пакужаби from до пакужаби to (по вузлах CONV2 → CONV1)
+function shipOnChains(scene, util, address) {
+  if (!Frogport) {
+    scene.overlay.showBigLine(PonderPalette.OUTPUT, [5.5, 3, 2.5], [2.5, 3, 5.5], 140)
+    scene.idle(150)
+    return
+  }
+  const box = addressedBox(address)
+  scene.world.modifyBlockEntity(util.grid.at(FROM_FROG[0], FROM_FROG[1], FROM_FROG[2]), Frogport, be => be.startAnimation(box, true))
+  scene.idle(95)
+  chainTransfer(scene, util, CONV1, CONV2)
+  scene.idle(45)
+  frogTakes(scene, util, CONV1, TO_FROG, box)
+  scene.idle(10)
+}
+
+function setSpeed(scene, util, sel, speed) {
+  if (CreateScene) new CreateScene(scene).world().setKineticSpeed(sel, speed)
+}
+
+// схематика Create «Transporting packages between Frogports» (9x9): ланцюги на висоті 4, дві пакужаби
+const FROG_STRUCTURE = 'create:high_logistics/package_frogport'
+const CONV1 = [1, 4, 7], CONV2 = [7, 4, 7]
+const FROM_FROG = [5, 2, 2], TO_FROG = [2, 2, 5]
+
+function addressedBox(address) {
+  const box = PackageStyles.getDefaultBox().copy()
+  PackageItem.addAddress(box, address)
+  return box
+}
+
+// посилки, що крутяться на одному ланцюговому вузлі, їдуть до іншого (Create: boxTransfer)
+function chainTransfer(scene, util, to, from) {
+  scene.world.modifyBlockEntity(util.grid.at(from[0], from[1], from[2]), ChainConveyor, be => {
+    const it = be.getLoopingPackages().iterator()
+    while (it.hasNext()) {
+      const p = it.next()
+      p.chainPosition = 0
+      be.addTravellingPackage(p, util.grid.at(to[0] - from[0], to[1] - from[1], to[2] - from[2]))
+      it.remove()
+    }
+  })
+}
+
+// пакужаба на прийомі: знімає посилки з вузла й «ковтає» їх
+function frogTakes(scene, util, conv, frog, box) {
+  scene.world.modifyBlockEntity(util.grid.at(conv[0], conv[1], conv[2]), ChainConveyor, be => be.getLoopingPackages().clear())
+  scene.world.modifyBlockEntity(util.grid.at(frog[0], frog[1], frog[2]), Frogport, be => be.startAnimation(box, false))
+}
+
+// спільна частина: мережа ланцюгів з'являється так само, як у Create
+function showChainNetwork(scene, util) {
+  scene.configureBasePlate(0, 0, 9)
+  scene.scaleSceneView(0.75)
+  scene.setSceneOffsetY(-1)
+  scene.world.showSection(util.select.layer(0).substract(util.select.position(9, 0, 1)), Direction.UP)
+  scene.idle(10)
+  scene.world.showSection(util.select.position(2, 1, 8), Direction.SOUTH)
+  scene.idle(2)
+  scene.world.showSection(util.select.fromTo(1, 1, 7, 1, 3, 7), Direction.DOWN)
+  scene.idle(2)
+  scene.world.showSection(util.select.fromTo(7, 1, 7, 7, 3, 7), Direction.DOWN)
+  scene.idle(2)
+  scene.world.showSection(util.select.fromTo(7, 1, 1, 7, 3, 1), Direction.DOWN)
+  scene.idle(5)
+  scene.world.showSection(util.select.position(1, 4, 7), Direction.DOWN)
+  scene.world.showSection(util.select.position(7, 4, 7), Direction.DOWN)
+  scene.world.showSection(util.select.position(7, 4, 1), Direction.DOWN)
+  scene.idle(20)
 }
 
 // ---------------------------------------------------------------------------------------------
@@ -45,87 +120,123 @@ function terminalScene(scene, util) {
 }
 
 // ---------------------------------------------------------------------------------------------
-// 2. Продаж державі
+// 2. Продаж державі (схематика Create з ланцюгами)
 
 function sellScene(scene, util) {
-  scene.showBasePlate()
+  showChainNetwork(scene, util)
-  // бізнес ліворуч: сховище → пакувальник → пакужаба; держава праворуч
+  scene.text(90, 'Бізнеси й держава з\'єднані _мережею ланцюгів_. Посилка сама знаходить пакужабу з потрібною адресою.', [4, 4.5, 7])
-  scene.world.setBlocks([0, 1, 2], 'minecraft:barrel')
-  scene.world.setBlocks([1, 1, 2], 'create:packager')
-  scene.world.setBlocks([1, 2, 2], 'create:package_frogport')
-  scene.world.setBlocks([3, 1, 2], 'create:packager')
-  scene.world.setBlocks([3, 2, 2], 'create:package_frogport')
-  scene.idle(10)
-
-  scene.world.showSection([0, 1, 2], Direction.DOWN)
-  scene.idle(5)
-  scene.world.showSection([1, 1, 2], Direction.DOWN)
-  scene.idle(5)
-  scene.world.showSection([1, 2, 2], Direction.DOWN)
-  scene.idle(15)
-
-  scene.text(90, 'Держава _купує_ все, що добувають і виробляють: руду, метали, будматеріали, їжу, деталі Create.', [1.5, 2.5, 2.5])
     .placeNearTarget().attachKeyFrame()
   scene.idle(100)
 
-  scene.text(100, 'Адреса продажу твого бізнесу — _gov-…_ (термінал → Бізнес → Адреса продажу). Познач нею пакувальник табличкою або в замовленні.', [1.5, 1.5, 2.5])
+  // бізнес: сховище, пакувальник з табличкою, пакужаба на ланцюгу
-    .placeNearTarget().attachKeyFrame()
+  scene.world.showSection(util.select.fromTo(7, 1, 2, 5, 1, 2), Direction.DOWN)
-  scene.showControls(70, [1.5, 1.8, 2], 'down').rightClick().withItem('minecraft:oak_sign')
+  scene.world.showSection(util.select.position(5, 1, 3), Direction.DOWN)
-  scene.idle(110)
+  scene.idle(5)
-
+  scene.world.showSection(util.select.position(4, 1, 2), Direction.EAST)
-  scene.world.showSection([3, 1, 2, 3, 2, 2], Direction.DOWN)
+  scene.world.showSection(util.select.position(5, 2, 2), Direction.DOWN)
   scene.idle(15)
-  scene.text(90, '_Державна пакужаба_ приймає посилки на всі адреси gov-… Під нею — державний приймач.', [3.5, 2.5, 2.5])
+  scene.text(110, 'Твій бізнес: сховище → _пакувальник_ → _пакужаба_ на ланцюгу. Табличка на пакувальнику — адреса продажу _gov-…_ (термінал → Бізнес → Адреса продажу).', [4.5, 1.5, 2.5])
+    .placeNearTarget().attachKeyFrame()
+  scene.idle(120)
+
+  // держава: пакужаба з фільтром gov-* і приймач під нею
+  scene.world.showSection(util.select.position(2, 1, 5), Direction.SOUTH)
+  scene.world.showSection(util.select.fromTo(2, 1, 4, 0, 1, 4), Direction.DOWN)
+  scene.idle(5)
+  scene.world.showSection(util.select.position(2, 2, 5), Direction.DOWN)
+  scene.idle(15)
+  scene.text(100, '_Державна пакужаба_ приймає посилки на всі адреси gov-… Під нею — державний приймач.', [2.5, 2.5, 5.5])
     .colored(PonderPalette.BLUE).placeNearTarget().attachKeyFrame()
-  scene.idle(100)
-
-  sendPackage(scene, [1.5, 3, 2.5], [3.5, 3, 2.5], 30)
-  scene.idle(5)
-
-  scene.text(100, 'Гроші приходять на _рахунок бізнесу_. Товару забагато — ціна падає, дефіцит — росте. Ціни — на табло й у терміналі.', [3.5, 1.5, 2.5])
-    .colored(PonderPalette.GREEN).placeNearTarget().attachKeyFrame()
   scene.idle(110)
 
-  scene.text(80, 'Усе автоматизується: ланцюги, поїзди, ферми — продаж іде, поки ти робиш інше.', [2.5, 3.5, 2.5])
+  scene.text(70, 'Посилка з адресою gov-… їде ланцюгами…', [6.78, 4.37, 3.5]).placeNearTarget()
+  shipOnChains(scene, util, 'gov-a1b2c3')
+  scene.text(110, '…до держави. Гроші — на _рахунок бізнесу_. Товару забагато — ціна падає, дефіцит — росте. Ціни — на табло й у терміналі.', [2.5, 2.5, 5.5])
+    .colored(PonderPalette.GREEN).placeNearTarget().attachKeyFrame()
+  scene.idle(120)
+
+  scene.text(80, 'Поїзди, ферми, ланцюги — продаж іде сам, поки ти робиш інше.', [4, 4.5, 4])
   scene.idle(90)
 }
 
 // ---------------------------------------------------------------------------------------------
-// 3. Покупка в держави
+// 3. Покупка в держави (та сама мережа, напрямок навпаки)
 
 function buyScene(scene, util) {
-  scene.showBasePlate()
+  showChainNetwork(scene, util)
-  scene.world.setBlocks([3, 1, 2], 'create:packager')
+  scene.world.showSection(util.select.fromTo(7, 1, 2, 5, 1, 2), Direction.DOWN)
-  scene.world.setBlocks([3, 2, 2], 'create:package_frogport')
+  scene.world.showSection(util.select.position(5, 1, 3), Direction.DOWN)
-  scene.world.setBlocks([0, 1, 2], 'minecraft:chest')
-  scene.world.setBlocks([1, 1, 2], 'create:packager')
-  scene.world.setBlocks([1, 2, 2], 'create:package_frogport')
-  scene.idle(10)
-
-  scene.world.showSection([3, 1, 2, 3, 2, 2], Direction.DOWN)
-  scene.idle(15)
-  scene.text(90, 'Держава продає _імпорт_ (алмази, незерит, елітри…) і _ліцензії_. Купівля — термінал → Магазин держави.', [3.5, 2.5, 2.5])
-    .placeNearTarget().attachKeyFrame()
-  scene.idle(100)
-
-  scene.world.showSection([0, 1, 2], Direction.DOWN)
   scene.idle(5)
-  scene.world.showSection([1, 1, 2, 1, 2, 2], Direction.DOWN)
+  scene.world.showSection(util.select.position(5, 2, 2), Direction.DOWN)
   scene.idle(15)
-  scene.text(100, 'Під час покупки вкажи _адресу своєї пакужаби_ — так, як вона названа. Термінал запам\'ятає її.', [1.5, 2.5, 2.5])
+  scene.text(100, '_Державний склад_: пакувальник і пакужаба держави на тій самій мережі ланцюгів.', [5.5, 2.5, 2.5])
+    .colored(PonderPalette.BLUE).placeNearTarget().attachKeyFrame()
+  scene.idle(110)
+
+  scene.text(100, 'Держава продає _імпорт_ (алмази, незерит, елітри…) і _ліцензії_. Купівля — термінал → Магазин держави.', [4, 4.5, 4])
     .placeNearTarget().attachKeyFrame()
   scene.idle(110)
 
-  scene.text(60, 'Товар виїжджає з _державного складу_…', [3.5, 3, 2.5]).colored(PonderPalette.BLUE)
+  scene.world.showSection(util.select.position(2, 1, 5), Direction.SOUTH)
-  scene.idle(20)
+  scene.world.showSection(util.select.fromTo(2, 1, 4, 0, 1, 4), Direction.DOWN)
-  sendPackage(scene, [3.5, 3, 2.5], [1.5, 3, 2.5], 30)
+  scene.world.showSection(util.select.position(3, 1, 5), Direction.DOWN)
-  scene.idle(20)
+  scene.idle(5)
+  scene.world.showSection(util.select.position(2, 2, 5), Direction.DOWN)
+  scene.idle(15)
+  scene.text(100, 'Твоя пакужаба з адресою, напр. _Склад Олі_. Цю назву вкажи під час покупки — термінал запам\'ятає.', [2.5, 2.5, 5.5])
+    .placeNearTarget().attachKeyFrame()
+  scene.idle(110)
 
-  scene.text(100, '…і приходить посилкою. _Пакувальник_ під твоєю пакужабою розпакує її у скриню.', [0.5, 1.5, 2.5])
+  shipOnChains(scene, util, 'Склад Олі')
+  scene.text(100, 'Посилка приходить сама. _Пакувальник_ під твоєю пакужабою розпакує її у скриню.', [3.5, 1.5, 5.5])
     .colored(PonderPalette.GREEN).placeNearTarget().attachKeyFrame()
   scene.idle(110)
 
-  scene.text(80, 'Не дійшла? Гроші _повертаються_ автоматично, а в чаті буде причина.', [2.5, 3.5, 2.5])
+  scene.text(80, 'Не дійшла? Гроші _повертаються_ автоматично, а в чаті буде причина.', [4, 4.5, 4])
+  scene.idle(90)
+}
+
+// ---------------------------------------------------------------------------------------------
+// 7. Продаж енергії державі
+
+function energyScene(scene, util) {
+  scene.showBasePlate()
+  scene.world.setBlocks([0, 1, 2], 'create:water_wheel[facing=east]')
+  scene.world.setBlocks([1, 1, 2], 'create:shaft[axis=x]')
+  scene.world.setBlocks([2, 1, 2], 'create:stressometer[facing=south,axis_along_first=true]')
+  scene.world.setBlocks([3, 1, 2], 'create:shaft[axis=x]')
+  scene.world.setBlocks([4, 1, 2], 'create:encased_fan[facing=east]')
+  scene.idle(10)
+
+  scene.world.showSection([0, 1, 2], Direction.DOWN)
+  scene.world.showSection([1, 1, 2], Direction.DOWN)
+  scene.idle(10)
+  setSpeed(scene, util, util.select.fromTo(0, 1, 2, 1, 1, 2), 16)
+  scene.text(90, 'Енергію теж можна _продавати державі_. Твій генератор — колесо, вітряк, двигун — крутить вал до державної мережі.', [0.5, 1.5, 2.5])
+    .placeNearTarget().attachKeyFrame()
+  scene.idle(100)
+
+  scene.world.showSection([3, 1, 2, 4, 1, 2], Direction.DOWN)
+  scene.idle(10)
+  scene.world.showSection([2, 1, 2], Direction.DOWN)
+  scene.idle(10)
+  setSpeed(scene, util, util.select.fromTo(0, 1, 2, 4, 1, 2), 16)
+  scene.overlay.showOutline(PonderPalette.GREEN, 'biz', util.select.fromTo(0, 1, 2, 1, 1, 2), 100)
+  scene.overlay.showOutline(PonderPalette.BLUE, 'state', util.select.fromTo(3, 1, 2, 4, 1, 2), 100)
+  scene.text(100, 'На стику — _державний лічильник_ (стресометр). Його ставить держава і прив\'язує до твого бізнесу.', [2.5, 1.8, 2.5])
+    .colored(PonderPalette.BLUE).placeNearTarget().attachKeyFrame()
+  scene.idle(110)
+
+  scene.text(110, 'Щохвилини держава платить бізнесу за _силу_ (SU), яку забирають її машини, — до ліміту лічильника.', [3.5, 1.5, 2.5])
+    .colored(PonderPalette.GREEN).placeNearTarget().attachKeyFrame()
+  scene.idle(120)
+
+  setSpeed(scene, util, util.select.fromTo(0, 1, 2, 4, 1, 2), 0)
+  scene.text(90, 'Генератор зупинився — оплата зупинилась. Перевантажив мережу — теж нічого не заробиш.', [1.5, 1.5, 2.5])
+    .colored(PonderPalette.RED).placeNearTarget()
+  scene.idle(100)
+  setSpeed(scene, util, util.select.fromTo(0, 1, 2, 4, 1, 2), 16)
+  scene.text(80, 'Хочеш лічильник? Звернися до держави — вона підключить твою електростанцію.', [2.5, 2.5, 2.5])
   scene.idle(90)
 }
 
@@ -239,22 +350,26 @@ function jobsScene(scene, util) {
 
 Ponder.tags(event => {
   event.createTag('kubejs:createrp', 'kubejs:citizen_guide', 'Держава Create RP',
-    'Як жити й заробляти в державній економіці: термінал, продаж і покупки посилками, гроші, земля, робота.',
+    'Як жити й заробляти в державній економіці: термінал, продаж і покупки посилками, енергія, гроші, земля, робота.',
-    ['kubejs:citizen_guide', 'create:package_frogport', 'computercraft:computer_advanced', 'computercraft:computer_normal', 'computercraft:monitor_advanced'])
+    ['kubejs:citizen_guide', 'create:package_frogport', 'computercraft:computer_advanced', 'computercraft:computer_normal', 'computercraft:monitor_advanced', 'create:stressometer'])
 })
 
 Ponder.registry(event => {
   event.create('kubejs:citizen_guide')
     .scene('guide_terminal', 'Термінал держави', terminalScene)
-    .scene('guide_sell', 'Продаж державі', sellScene)
+    .scene('guide_sell', 'Продаж державі', FROG_STRUCTURE, sellScene)
-    .scene('guide_buy', 'Покупки в держави', buyScene)
+    .scene('guide_buy', 'Покупки в держави', FROG_STRUCTURE, buyScene)
+    .scene('guide_energy', 'Продаж енергії державі', energyScene)
     .scene('guide_money', 'Гроші й банк', moneyScene)
     .scene('guide_land', 'Земля й надра', landScene)
     .scene('guide_jobs', 'Робота: ринок праці й пошта', jobsScene)
 
   event.create('create:package_frogport')
-    .scene('frogport_sell', 'Create RP: продаж державі', sellScene)
+    .scene('frogport_sell', 'Create RP: продаж державі', FROG_STRUCTURE, sellScene)
-    .scene('frogport_buy', 'Create RP: покупки в держави', buyScene)
+    .scene('frogport_buy', 'Create RP: покупки в держави', FROG_STRUCTURE, buyScene)
+
+  event.create('create:stressometer')
+    .scene('stressometer_energy', 'Create RP: продаж енергії державі', energyScene)
 
   event.create(['computercraft:computer_advanced', 'computercraft:computer_normal'])
     .scene('computer_terminal', 'Create RP: термінал держави', terminalScene)

pack.toml

@@ -1,12 +1,12 @@
 name = "Create RP"
 author = "Pinecraft-CreateRP"
-version = "0.6.0"
+version = "0.6.1"
 pack-format = "packwiz:1.1.0"
 
 [index]
 file = "index.toml"
 hash-format = "sha256"
-hash = "6502e1eebae1d8993f10f350f6d1ffe6554b04211de7f0646bbcc2212a6c2852"
+hash = "2a8313cb0a107c64dc9c434c0f331fdc545223c9d9293fb7fc57b85ca54256fa"
 
 [versions]
 minecraft = "1.21.1"