Tiny Farm CLI v0.3.0

เกมฟาร์ม CLI แบบบันทึกต่อเนื่อง รองรับหลาย FARM สำหรับ Node.js + blessed

มี autosave ทุก 5 วินาที และบันทึกอีกครั้งก่อนออก ออกเกมได้ด้วย Ctrl+C เท่านั้น

เริ่มเล่น

ติดตั้งจาก npm แบบ global:

npm install -g @buildifyx/tiny-farm-cli
tfc

หลังติดตั้งสามารถใช้คำสั่งเดิม tiny-farm แทน tfc ได้เช่นกัน

เมื่อเปิดเกมผ่าน tfc หรือ tiny-farm ระบบจะตรวจเวอร์ชันล่าสุดจาก npm หากมีเวอร์ชันใหม่กว่าจะมี popup แนะนำให้อัปเดตด้วย:

npm install -g @buildifyx/tiny-farm-cli@latest

ระบบจะแจ้งเตือนเท่านั้นและไม่อัปเดตให้อัตโนมัติ หาก offline, registry เข้าไม่ได้ หรือเกินเวลารอประมาณ 1.5 วินาที เกมจะเปิดต่อทันทีโดยไม่แสดง error การรันด้วย npm start จะข้ามการตรวจนี้เพื่อไม่รบกวนการพัฒนา

หรือรันจาก source:

npm install
npm start

หรือทำเป็นคำสั่ง:

npm link
tfc
tiny-farm

ระบบ Save

เกมจะโหลด save.json อัตโนมัติเมื่อเปิด และ autosave ทุก 5 วินาที รวมถึงรอ final save ให้เสร็จก่อนออกด้วย Ctrl+C

เวลาภายในเกมจะหยุดระหว่างปิดโปรแกรม ทั้งการเติบโตของผัก โบนัส Perfect, Contracts, Weather, ราคาตลาด และ Automation cooldown

ตำแหน่งไฟล์:

• macOS: ~/Library/Application Support/tiny-farm-cli/save.json
• Linux: $XDG_DATA_HOME/tiny-farm-cli/save.json หรือ ~/.local/share/tiny-farm-cli/save.json
• Windows: %LOCALAPPDATA%\tiny-farm-cli\save.json

มีไฟล์ save ถาวรเพียงไฟล์เดียว ไม่มี backup หากไม่พบไฟล์, JSON อ่านไม่ได้ หรือโครงสร้างไม่ถูกต้อง เกมจะเริ่มฟาร์มใหม่และ autosave ทับด้วยข้อมูลใหม่ในรอบถัดไป

ลบ save และเริ่มใหม่:

tfc --reset-save

ระบบจะถามยืนยัน y/N ก่อนลบไฟล์ และสามารถใช้ tiny-farm --reset-save ได้เช่นกัน

คำสั่ง CLI และการเปิดเกมซ้ำ

Dev และ global ใช้ save.json และ runtime lock ร่วมกัน เกมจึงเปิดได้ครั้งละหนึ่ง instance เท่านั้น หากเปิดอีกแท็บ ระบบจะแจ้ง PID ของเกมที่กำลังรันและจะไม่โหลดหรือเขียน save

game.lock จะถูกลบหลัง final save ตอนออกตามปกติ หากโปรเซสตายและทิ้ง stale lock ไว้ ระบบจะตรวจ PID ล้าง lock และเปิดเกมต่ออัตโนมัติ

| คำสั่ง | รายละเอียด | | --- | --- | | tfc | เปิดเกม | | tfc -h, tfc --help | แสดงคำสั่งและตัวอย่างทั้งหมด | | tfc -v, tfc --version | แสดงเวอร์ชันที่ติดตั้ง | | tfc --game-status | ตรวจว่าเกมกำลังรันอยู่หรือไม่ | | tfc --stop-game | สั่ง final save และปิดเกมแบบ graceful | | tfc --force-stop-game | บังคับปิดหลังยืนยัน; progress หลัง autosave ล่าสุดอาจหาย | | tfc --reset-save | ลบ save.json หลังยืนยัน; ใช้ไม่ได้ขณะเกมรัน |

ทุก option ใช้กับ tiny-farm ได้เช่นกัน สำหรับ dev ใช้รูปแบบ npm start -- --game-status

ปุ่มหลัก

• Arrow keys — เลื่อน cursor
• [ / ] — สลับไป FARM ก่อนหน้า/ถัดไป
• P — Plant / เลือกผัก
• W — Water
• H — Harvest
• Enter — ทำ action กับช่องปลูกที่เลือก
• F — Fertilize
• B — Seed Shop
• M — Bag / ดูและขายผลผลิตแยกตามคุณภาพ
• C — Contracts
• E — Harvest Guild / แลกผลผลิตเป็น Research และ Boost
• R — Automation
• U — Speed Upgrades
• ? / F1 — Help
• Ctrl+C — ออกจากเกม

การปิดเมนู

ไม่มีการใช้ Esc

เมนูทั่วไปปิดได้ด้วย Q หรือปุ่มเดิมที่ใช้เปิด ส่วนกระเป๋าใช้ Q เพื่อย้อนกลับเมื่ออยู่หน้าคุณภาพ:

• Plant: P / Q
• Seed Shop: B / Q
• Bag: M ปิดได้ทุกหน้า; Q ย้อนจากหน้าคุณภาพหรือปิดจากหน้ารายการผัก
• Contracts: C / Q
• Harvest Guild: E ปิดทุกหน้า; Q ย้อนหน้าหรือปิดจากหน้าแรก
• Automation: R / Q
• Upgrades: U / Q
• Help: ? / F1 / Q

Q ที่หน้าหลักจะไม่ออกเกม

ระบบหลาย FARM

ผู้เล่นเริ่มด้วย FARM ขนาด 6×4 จำนวนหนึ่งแปลง และปลดล็อกเพิ่มทุก 10 เลเวล:

• Lv10 ปลดล็อก FARM 2
• Lv20 ปลดล็อก FARM 3
• ปลดล็อกต่อเนื่องจนถึง FARM 10 ที่ Lv90
• สูงสุด 10 FARM แม้เลเวลมากกว่า 90

กด [ และ ] เพื่อสลับ FARM แบบวนรอบ พืช สภาพอากาศ และ Automation ในทุก FARM ยังทำงานพร้อมกันแม้กำลังดูแปลงอื่น เงิน เมล็ด กระเป๋า ตลาด และสัญญาใช้ร่วมกัน

Save จาก v0.1.0, v0.2.0 และ schema v3 โหลดต่อได้ตามปกติ ระบบจะ migrate เป็น schema v4 แบบ atomic ก่อนเปิดเกม โดยรักษาเงิน XP กระเป๋า FARM, Automation และ Guild เดิมทั้งหมด ข้อมูล v0.1.0 และ Automation เดิมจะอยู่ใน FARM 1 ส่วน FARM เพิ่มเติมปลดล็อกตามเลเวลและเริ่มเป็นแปลงว่าง

Perfect Harvest

ผักทุกชนิดมีโอกาสเป็น Perfect คงที่ 10% เมื่อเก็บด้วยมือภายใน 8 วินาทีหลังโตเต็มที่และ Fertility อย่างน้อย 70% โดยผักต้นนั้นต้องไม่เคยถูก Auto Planter ปลูกหรือ Sprinkler รดน้ำ การเปิดเครื่องทิ้งไว้โดยเครื่องยังไม่ทำงานกับผักต้นนั้นไม่ตัดสิทธิ์ และน้ำฝนไม่นับเป็น Automation

Auto Harvester ไม่สามารถเก็บ Perfect ได้ ส่วน Quality Mastery และ Quality Focus เพิ่มโอกาส Good/Great เท่านั้นและไม่เพิ่มโอกาส Perfect

Automation v0.2

Automation ทั้ง 3 ตัวซื้อได้ตั้งแต่เริ่มเกม ไม่มี level lock:

• Sprinkler
• Auto Planter
• Auto Harvester

เอาข้อจำกัดพวกนี้ออกแล้ว:

• ไม่มี Power limit
• ไม่มี Water tank
• ไม่มี Automation level lock
• Storage ไม่จำกัด
• Sprinkler ใช้น้ำไม่จำกัด

Auto Planter จะใช้ seed ที่มีอยู่ก่อน หาก seed หมดจะซื้อ seed ให้อัตโนมัติเมื่อเงินพอ

เครื่องยังต้อง ซื้อก่อน และต้องเปิด ON

Automation การตั้งค่า และ Speed Upgrade แยกเป็นของแต่ละ FARM เครื่องจาก FARM หนึ่งจะไม่ทำงานให้อีก FARM

Harvest Guild

Harvest Guild เปิดที่ Lv10 กด E เพื่อเข้าเมนู แล้วใช้ 1 เปิด Research หรือ 2 เปิด Boosts เลือกรายการด้วย Enter เพื่อดูสูตรและจำนวน Have/Need จากนั้นกด Enter อีกครั้งเพื่อแลก

การแลกใช้ชนิดและคุณภาพตามสูตรแบบตรงตัว คุณภาพสูงกว่าใช้แทนคุณภาพที่ขาดไม่ได้ ถ้าวัตถุดิบไม่ครบระบบจะไม่หักผลผลิตบางส่วน

Research เป็นโบนัสถาวรส่วนกลาง สูงสุดชนิดละ 5 ระดับ:

• Growth Mastery — เพิ่มความเร็วเติบโต 5% ต่อระดับ
• Quality Mastery — เพิ่ม quality luck 3 จุดเปอร์เซ็นต์ต่อระดับ
• Soil Conservation — ลด fertility loss 5% ต่อระดับ
• Trade Mastery — เพิ่มราคาขายใน Bag 3% ต่อระดับ

ระดับ Research ที่จะซื้อกำหนดคุณภาพและตัวคูณสูตรเป็น Normal ×1, Good ×1, Good ×2, Great ×2, Perfect ×2 ตามลำดับ Lv1–Lv5

Boost มี 4 แบบและทำงานทุก FARM เป็นเวลา 5 นาที ซื้อซ้ำเพื่อต่อเวลาได้:

• Growth Surge — ความเร็วเติบโต ×2
• Quality Focus — quality luck +20 จุดเปอร์เซ็นต์
• Soil Shield — เก็บเกี่ยวโดยไม่เสีย fertility
• Automation Overdrive — Automation ทำงานเร็วขึ้น ×2

สูตรของ Research และ Boost แต่ละรายการใช้ผัก คุณภาพ และจำนวนต่างกัน ตรวจสูตรปัจจุบันได้จากเมนู Harvest Guild

Speed Upgrade

กด U เพื่ออัปเกรดความเร็วแยกแต่ละเครื่อง

• Sprinkler Speed
• Auto Planter Speed
• Auto Harvester Speed

แต่ละอัปเกรดจะลดเวลาต่อ action ลง และราคาจะสูงขึ้นเรื่อย ๆ

กระเป๋าและการขาย

กด M เพื่อเปิดกระเป๋า หน้าแรกจะแสดงผลผลิตแยกตามชนิดผัก พร้อมจำนวนรวมและจำนวนคุณภาพ Normal, Good, Great, Perfect

• กด Enter ที่ชนิดผักเพื่อเปิดรายละเอียดคุณภาพ
• กด Enter ที่คุณภาพเพื่อขาย 1 ชิ้น
• กด A เพื่อขายทั้งหมดเฉพาะคุณภาพที่เลือก
• กด Q เพื่อย้อนกลับไปหน้ารายการผัก
• กด M เพื่อปิดกระเป๋าจากหน้าใดก็ได้

ราคาขายยังเปลี่ยนทุก 45 วินาที และคำนวณจากราคาพื้นฐาน ตัวคูณตลาด และคุณภาพผลผลิต

ระบบอื่น

• ผัก 10 ชนิด
• XP / Level, crop unlock และ FARM unlock สูงสุด 10 แปลง
• กระเป๋าแยกชนิดและคุณภาพ พร้อมราคาตลาดที่ขึ้นลง
• Contracts
• Crop quality
• Perfect manual harvest bonus
• Soil fertility
• Weather
• Autosave และโหลดเกมอัตโนมัติ