0.6.0: in-game tutorial in Create's Ponder style

- Ponder for KubeJS 2.4.0 (client) + client_scripts/createrp_ponder.js: six scenes (terminal, selling, buying, money and bank, land and ore, jobs) on «Довідник громадянина», frogport and CC computers, plus a «Держава Create RP» tag in the Ponder index - startup_scripts/createrp_items.js registers kubejs:citizen_guide (identical in the server pack) Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-03 06:32:31 +03:00
5 changed files with 304 additions and 2 deletions
@@ -812,6 +812,14 @@ hash = "19b844245d03fcdd488a7a791e287447191a74acd0f14995209339d768c5e6ce"
 file = "kubejs/assets/computercraft/textures/gui/term_font.png"
 hash = "db4c4a8ab49265f6e8e456f495800ea148b133b18a3242aabca30b98ab7f784f"
 [[files]]
 file = "kubejs/client_scripts/createrp_ponder.js"
 hash = "193c9f8b283e32f85504f8b198869d80f6ba1647924884a7f0db7de5eb8c6b47"
 [[files]]
 file = "kubejs/startup_scripts/createrp_items.js"
 hash = "58100f02cf749b138c2a91567df37afce4b2ef494738268963e8443a3e603036"
 [[files]]
 file = "mods/3dskinlayers.pw.toml"
 hash = "82becc6910845ae1a68884e6f7a3dcdc861d79a087ae81b1d7e120e82884372d"
@@ -1242,6 +1250,11 @@ file = "mods/polytone.pw.toml"
 hash = "636f08c84e9a1e1793850aa4f2390e5ece8fc25abee1d5d83679f3813e113802"
 metafile = true
 [[files]]
 file = "mods/ponder.pw.toml"
 hash = "5ead8d8bc26cdbe1a17dc055f7f0fe762a08254d0199d6ea8fcc58839ab274f2"
 metafile = true
 [[files]]
 file = "mods/puzzles-lib.pw.toml"
 hash = "6812c3faa178cd48c65c5b8e7aeef50bc0b63d8e3b2117065d6179a43d8d3649"
@@ -0,0 +1,264 @@
 // Create RP — туторіал у стилі Create (Ponder): наведи на предмет і затисни W.
 // Потрібні PonderJS (мод «Ponder for KubeJS») і startup_scripts/createrp_items.js (предмет kubejs:citizen_guide).
 // Сцени будуються на стандартній плиті 5x5: y=0 — плита, блоки з y=1. Текст: _слово_ — підсвітка, як у Create.
 const PACKAGE = 'create:cardboard_package_10x12'
 // посилка «летить» від однієї пакужаби до іншої: лінія маршруту + предмет-посилка
 function sendPackage(scene, from, to, ticks) {
  scene.overlay.showBigLine(PonderPalette.OUTPUT, from, to, ticks)
  const dx = (to[0] - from[0]) / ticks, dy = 0.22, dz = (to[2] - from[2]) / ticks
  const box = scene.world.createItemEntity(from, [dx, dy, dz], PACKAGE)
  scene.idle(ticks)
  scene.world.removeEntity(box)
 }
 // ---------------------------------------------------------------------------------------------
 // 1. Термінал держави
 function terminalScene(scene, util) {
  scene.showBasePlate()
  scene.world.setBlocks([2, 1, 2], 'computercraft:computer_advanced')
  scene.world.setBlocks([1, 1, 3, 3, 2, 3], 'computercraft:monitor_advanced')
  scene.idle(10)
  scene.world.showSection([2, 1, 2], Direction.DOWN)
  scene.idle(15)
  scene.text(80, 'Будь-який _комп\'ютер_ — це термінал держави. Відкрий його й набери _rp_.', [2.5, 1.5, 2.5])
    .placeNearTarget().attachKeyFrame()
  scene.showControls(60, [2.5, 2, 2.5], 'down').rightClick()
  scene.idle(90)
  scene.text(90, 'Вхід — твій _нік_ і _пароль_. Першого разу термінал попросить створити пароль. Стій поруч із комп\'ютером — здалеку не пустить.', [2.5, 1.5, 2.5])
    .placeNearTarget().attachKeyFrame()
  scene.idle(100)
  scene.text(90, 'У меню: _рахунок_, _бізнес_, _ціни_, _магазин_, _земля_, _робота_, _тендери_, _банк_. Стрілки й Enter, Backspace — назад.', [2.5, 1.5, 2.5])
    .placeNearTarget()
  scene.idle(100)
  scene.world.showSection([1, 1, 3, 3, 2, 3], Direction.DOWN)
  scene.idle(15)
  scene.text(90, 'Комп\'ютер з _монітором_ — табло цін держави: програма _prices metal_ (або stone, wood, farm, food, create…).', [2, 2.5, 3])
    .colored(PonderPalette.BLUE).placeNearTarget().attachKeyFrame()
  scene.idle(100)
 }
 // ---------------------------------------------------------------------------------------------
 // 2. Продаж державі
 function sellScene(scene, util) {
  scene.showBasePlate()
  // бізнес ліворуч: сховище → пакувальник → пакужаба; держава праворуч
  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.showControls(70, [1.5, 1.8, 2], 'down').rightClick().withItem('minecraft:oak_sign')
  scene.idle(110)
  scene.world.showSection([3, 1, 2, 3, 2, 2], Direction.DOWN)
  scene.idle(15)
  scene.text(90, '_Державна пакужаба_ приймає посилки на всі адреси gov-… Під нею — державний приймач.', [3.5, 2.5, 2.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.idle(90)
 }
 // ---------------------------------------------------------------------------------------------
 // 3. Покупка в держави
 function buyScene(scene, util) {
  scene.showBasePlate()
  scene.world.setBlocks([3, 1, 2], 'create:packager')
  scene.world.setBlocks([3, 2, 2], 'create:package_frogport')
  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.idle(15)
  scene.text(100, 'Під час покупки вкажи _адресу своєї пакужаби_ — так, як вона названа. Термінал запам\'ятає її.', [1.5, 2.5, 2.5])
    .placeNearTarget().attachKeyFrame()
  scene.idle(110)
  scene.text(60, 'Товар виїжджає з _державного складу_…', [3.5, 3, 2.5]).colored(PonderPalette.BLUE)
  scene.idle(20)
  sendPackage(scene, [3.5, 3, 2.5], [1.5, 3, 2.5], 30)
  scene.idle(20)
  scene.text(100, '…і приходить посилкою. _Пакувальник_ під твоєю пакужабою розпакує її у скриню.', [0.5, 1.5, 2.5])
    .colored(PonderPalette.GREEN).placeNearTarget().attachKeyFrame()
  scene.idle(110)
  scene.text(80, 'Не дійшла? Гроші _повертаються_ автоматично, а в чаті буде причина.', [2.5, 3.5, 2.5])
  scene.idle(90)
 }
 // ---------------------------------------------------------------------------------------------
 // 4. Гроші й банк
 function moneyScene(scene, util) {
  scene.showBasePlate()
  scene.world.setBlocks([2, 1, 2], 'computercraft:computer_advanced')
  scene.world.showSection([2, 1, 2], Direction.DOWN)
  scene.idle(15)
  scene.text(90, 'Твої гроші — на _рахунку_ в державному банку. Баланс і перекази — термінал → Рахунок.', [2.5, 1.5, 2.5])
    .placeNearTarget().attachKeyFrame()
  scene.idle(100)
  const coins = ['numismatics:spur', 'numismatics:bevel', 'numismatics:sprocket', 'numismatics:cog']
  for (let i = 0; i < coins.length; i++) {
    scene.world.createItemEntity([1 + i, 3, 1], [0, 0.1, 0], coins[i])
    scene.idle(5)
  }
  scene.idle(10)
  scene.text(110, '_Готівка_ — монети: зняти /cash withdraw <сума>, покласти — /cash deposit з монетами в руці. Готівкою платять одне одному з рук.', [2.5, 2, 1.5])
    .colored(PonderPalette.GREEN).placeNearTarget().attachKeyFrame()
  scene.idle(120)
  scene.text(100, '_Банк_ (термінал → Банк): стартовий та інвестиційний кредити для бізнесу, вклади під відсоток щодня.', [2.5, 1.5, 2.5])
    .placeNearTarget().attachKeyFrame()
  scene.idle(110)
  scene.text(90, 'Кредит платиться щоденними внесками. Пропустиш тричі — _дефолт_: рахунок бізнесу заморожено, тендери заборонені.', [2.5, 1.5, 2.5])
    .colored(PonderPalette.RED).placeNearTarget()
  scene.idle(100)
 }
 // ---------------------------------------------------------------------------------------------
 // 5. Земля й надра
 function landScene(scene, util) {
  scene.showBasePlate()
  scene.world.setBlocks([1, 1, 1], 'minecraft:oak_fence')
  scene.world.setBlocks([3, 1, 1], 'minecraft:oak_fence')
  scene.world.setBlocks([1, 1, 3], 'minecraft:oak_fence')
  scene.world.setBlocks([3, 1, 3], 'minecraft:oak_fence')
  scene.world.setBlocks([2, 1, 2], 'minecraft:iron_ore')
  scene.idle(10)
  scene.text(90, 'Уся незареєстрована земля _належить державі_. Будувати можна на своїх ділянках.', [2.5, 1, 2.5])
    .placeNearTarget().attachKeyFrame()
  scene.idle(100)
  scene.overlay.showOutline(PonderPalette.GREEN, 'plot', util.select.fromTo(0, 0, 0, 4, 0, 4), 120)
  scene.world.showSection([1, 1, 1, 3, 1, 3], Direction.DOWN)
  scene.text(110, '_Ділянки_ орендують на ігрові дні або викуповують: термінал → Земля. Заходячи на ділянку, бачиш її назву над хотбаром.', [2.5, 1.5, 2.5])
    .colored(PonderPalette.GREEN).placeNearTarget().attachKeyFrame()
  scene.idle(120)
  scene.text(100, 'Орендована ділянка — _приват_ бізнесу: чужі не ламають, а твої працівники мають доступ.', [2.5, 1.5, 2.5])
    .placeNearTarget()
  scene.idle(110)
  scene.overlay.showOutline(PonderPalette.RED, 'ore', util.select.position(2, 1, 2), 100)
  scene.text(100, '_Руда_ видобувається за _концесією_: купи дозвіл на руду й квоту на ділянці (термінал → Земля → Купити концесію).', [2.5, 1.5, 2.5])
    .colored(PonderPalette.RED).placeNearTarget().attachKeyFrame()
  scene.idle(110)
  scene.text(80, 'За землю щодня — орендна плата або податок. Не заплатив 3 дні — ділянка повертається державі.', [2.5, 2.5, 2.5])
  scene.idle(90)
 }
 // ---------------------------------------------------------------------------------------------
 // 6. Робота: ринок праці і пошта
 function jobsScene(scene, util) {
  scene.showBasePlate()
  scene.idle(10)
  const post = scene.world.createEntity('minecraft:villager', [1, 1, 2.5])
  scene.idle(10)
  scene.text(90, 'Немає роботи? Термінал → Робота → _ринок праці_: допомога по безробіттю щодня, якщо ти був активний у грі.', [2.5, 2.5, 2.5])
    .placeNearTarget().attachKeyFrame()
  scene.idle(100)
  scene.text(90, 'Хочеш заробляти більше — стань _поштарем_. Клікни по NPC пошти.', [1, 2.5, 2.5])
    .colored(PonderPalette.BLUE).placeNearTarget().attachKeyFrame()
  scene.showControls(60, [1, 2.3, 2.5], 'down').rightClick()
  scene.idle(70)
  scene.world.createItemEntity([1.5, 2, 2.5], [0.05, 0.25, 0], PACKAGE)
  scene.world.createItemEntity([1.5, 2, 2.5], [0.03, 0.3, 0.03], 'minecraft:compass')
  scene.idle(20)
  scene.text(100, 'Отримаєш _посилку_ з іменем адресата й _компас_, що вказує на нього. ПКМ компасом — мітка на місці (видно лише тобі).', [2, 1.5, 2.5])
    .placeNearTarget().attachKeyFrame()
  scene.idle(110)
  scene.world.createEntity('minecraft:villager', [4, 1, 2.5])
  scene.overlay.showBigLine(PonderPalette.OUTPUT, [1.5, 1.2, 2.5], [4, 1.2, 2.5], 80)
  scene.text(100, 'Адресат чекає в іншій частині світу. Принеси посилку й клікни по ньому — гроші на рахунок. Що далі, то дорожче.', [4, 2.5, 2.5])
    .colored(PonderPalette.GREEN).placeNearTarget().attachKeyFrame()
  scene.idle(110)
  scene.text(80, 'На доставку — _2 ігрові дні_. Не встиг — адресат поїде, і посилка згорить.', [2.5, 2.5, 2.5])
    .colored(PonderPalette.RED)
  scene.idle(90)
  scene.text(90, 'Або наймися до бізнесу: власник пропонує зарплату, ти приймаєш у терміналі → Бізнес → Прийняти запрошення.', [2.5, 2.5, 2.5])
  scene.idle(100)
 }
 // ---------------------------------------------------------------------------------------------
 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'])
 })
 Ponder.registry(event => {
  event.create('kubejs:citizen_guide')
    .scene('guide_terminal', 'Термінал держави', terminalScene)
    .scene('guide_sell', 'Продаж державі', sellScene)
    .scene('guide_buy', 'Покупки в держави', buyScene)
    .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_buy', 'Create RP: покупки в держави', buyScene)
  event.create(['computercraft:computer_advanced', 'computercraft:computer_normal'])
    .scene('computer_terminal', 'Create RP: термінал держави', terminalScene)
  event.create('computercraft:monitor_advanced')
    .scene('monitor_terminal', 'Create RP: термінал і табло цін', terminalScene)
 })
@@ -0,0 +1,12 @@
 // Create RP — предмети збірки. Цей файл має бути ОДНАКОВИМ у серверній і клієнтській збірках:
 // реєстр предметів сервера й клієнта мусить збігатися.
 StartupEvents.registry('item', event => {
  // «Довідник громадянина»: навести в інвентарі й затиснути W — туторіал Ponder (клієнтський client_scripts/createrp_ponder.js)
  event.create('citizen_guide')
    .displayName('Довідник громадянина')
    .texture('minecraft:item/knowledge_book')
    .maxStackSize(1)
    .glow(true)
    .tooltip('§7Наведи в інвентарі й затисни §fW§7 — як у Create')
 })
@@ -0,0 +1,13 @@
 name = "Ponder for KubeJS"
 filename = "ponderjs-neoforge-1.21.1-2.4.0.jar"
 side = "client"
 [download]
 url = "https://cdn.modrinth.com/data/5A34Stj8/versions/BqhDf7W8/ponderjs-neoforge-1.21.1-2.4.0.jar"
 hash-format = "sha512"
 hash = "6390c4bf631561c29a76b8b29a496d4b984bf847572940b28e551f2c2e3da4a8fb04b6a82cf98a7935792a7d3485cdc45c76f2bdf7f93799210262ba5f184955"
 [update]
 [update.modrinth]
 mod-id = "5A34Stj8"
 version = "BqhDf7W8"
@@ -1,12 +1,12 @@
 name = "Create RP"
 author = "Pinecraft-CreateRP"
-version = "0.5.0"
+version = "0.6.0"
 pack-format = "packwiz:1.1.0"
 [index]
 file = "index.toml"
 hash-format = "sha256"
-hash = "5efee6e704068bfd1642a913e0812e57f779941fd2c6d043c66c738351447a78"
+hash = "6502e1eebae1d8993f10f350f6d1ffe6554b04211de7f0646bbcc2212a6c2852"
 [versions]
 minecraft = "1.21.1"