release(v25.0.2): clean public repo metadata and english copy

Author: rygroup-dev

README.md

@@ -1,59 +1,44 @@
 # Owntown Farming Bot
 
-Bot farming otomatis untuk `owntown.fun` dengan kontrol Telegram.
+Automated `owntown.fun` farming bot with Telegram control and monitoring.
 
-Repo ini saat ini masih berbentuk **monolith**:
-- `bot.js` = logika utama bot
-- `telegram.js` = integrasi Telegram Bot API
-- `config.js` = loader `.env`
+## Features
 
-README ini sudah dirapikan supaya **sesuai implementasi real** di repo, bukan gabungan roadmap/claim lama.
+- Solana wallet authentication via challenge-response
+- `socket.io-client` game connection
+- Mining, fishing, combat, and PvP activity loops
+- Marketplace scanning with `MARKETPLACE` / `QUICKSELL` / `HOLD` decisions
+- Telegram control, reporting, and remote maintenance commands
+- Time-based online/offline scheduling
+- Bank, candy, boss, world, market, trades, listings, inventory, and health commands
 
-## Status Repo
-
-Yang benar-benar ada di repo:
-- autentikasi wallet Solana via challenge-response
-- koneksi game via `socket.io-client`
-- loop aktivitas mining, fishing, combat, PvP
-- marketplace scanning + smart sell decision
-- quick sell untuk item tertentu
-- kontrol dan monitoring lewat Telegram
-- schedule on/off berbasis jam
-- bank, candy, boss, world, market, trades, listings, inventory, health
-
-Yang **tidak** ada sebagai modul terpisah:
-- `errorbus.js`
-- `selfheal.js`
-- `autopatch.js`
-
-Jadi kalau ada klaim self-fix/autopatch modular, itu **bukan kondisi repo saat ini**.
-
-## Struktur
+## Project Layout
 
 ```text
 bot.js
 telegram.js
 config.js
+lib/
+test/
 install.sh
 owntown-bot.service
-README.md
 ```
 
-## Install
+## Installation
 
 ### One-line install
 
 ```bash
 bash <(curl -fsSL https://raw.githubusercontent.com/rygroup-dev/owntown-farming-bot/main/install.sh)
 ```
 
-Pinned stable release:
+### Pinned release install
 
 ```bash
-OWNTOWN_REF=v25.0.1 bash <(curl -fsSL https://raw.githubusercontent.com/rygroup-dev/owntown-farming-bot/main/install.sh)
+OWNTOWN_REF=v25.0.2 bash <(curl -fsSL https://raw.githubusercontent.com/rygroup-dev/owntown-farming-bot/main/install.sh)
 ```
 
-### Manual
+### Manual install
 
 ```bash
 git clone https://github.com/rygroup-dev/owntown-farming-bot.git
@@ -62,23 +47,21 @@ npm install
 cp .env.example .env
 ```
 
-Isi minimal `.env`:
+Minimum `.env` values:
 
 ```env
 WALLET_PRIVATE_KEY=your_base58_private_key
 TELEGRAM_BOT_TOKEN=123456:AA...
 ```
 
-Lalu jalankan:
+Run the bot:
 
 ```bash
 npm start
 ```
 
 ## Telegram Commands
 
-Command yang benar-benar terdaftar di `bot.js` saat ini:
-
 - `/help`
 - `/start`
 - `/stop`
@@ -110,63 +93,16 @@ Command yang benar-benar terdaftar di `bot.js` saat ini:
 - `/restart`
 - `/update`
 
-Total command handler aktif: **30**
-
-## Fitur yang Terkonfirmasi
-
-### Core gameplay
-- mining
-- fishing
-- combat
-- PvP queue/attack/result handling
-
-### Economy
-- scan harga marketplace
-- decision `MARKETPLACE` / `QUICKSELL` / `HOLD`
-- quick sell aman untuk item tertentu
-- flip opportunity check
-- powerup buy check
-- profit tracking per jam
-
-### Utility
-- token refresh / reauth
-- reconnect scheduling
-- schedule on/off
-- Telegram monitoring dan remote control
-
 ## Testing
 
-Repo ini sekarang punya smoke test dasar untuk:
-- syntax check file utama
-- validasi command Telegram utama terdaftar
-- validasi decision logic market + parser schedule
-
-Jalankan:
-
 ```bash
 npm test
 ```
 
-## Catatan Arsitektur
-
-Hal yang masih perlu diketahui:
-- `bot.js` masih sangat besar dan menampung terlalu banyak tanggung jawab
-- dokumentasi sebelumnya overclaim dibanding kode real
-- refactor ideal berikutnya adalah memecah:
-  - auth/api
-  - market logic
-  - activity loop
-  - telegram commands
-  - scheduling/state
-
-## Rekomendasi Lanjutan
-
-Kalau repo ini mau dibikin lebih sehat, urutan yang masuk akal:
-
-1. pisahkan `bot.js` jadi modul-modul kecil
-2. tambahkan unit test untuk market decision, schedule, dan Telegram command layer
-3. bikin README tetap sinkron dengan implementasi real
+The test suite covers syntax checks, Telegram command registration, market decision logic, and schedule parsing.
 
-## Disclaimer
+## Notes
 
-Gunakan dengan risiko sendiri. Server game bisa berubah kapan saja dan membuat flow bot perlu disesuaikan lagi.
+- This repository ships the currently implemented bot only.
+- Keep `.env`, wallet credentials, and Telegram tokens private.
+- Game-side API or protocol changes may require bot updates.

bot.js

@@ -61,7 +61,7 @@ function scheduleStart(ms) {
   retryTimer = setTimeout(() => { retryTimer = null; startBot(); }, ms);
 }
 
-log('=== OWNTOWN SMART FARMER v25.0.1 ===');
+log('=== OWNTOWN SMART FARMER v25.0.2 ===');
 log('AUTO ORCHESTRATOR: Mining+Fishing+Combat+PvP+Quest+Candy+Market+Bank+Crafting');
 
 // ============ CONSTANTS ============
@@ -454,23 +454,23 @@ tg.on('help',()=>notify([
   '🏭 <b>OWNTOWN v25 — Smart Orchestrator</b>',
   '',
   '📊 <b>Dashboard</b>',
-  '/status — dashboard lengkap',
-  '/balance — saldo OTWN+Candy+Chip',
-  '/daily — laporan harian',
-  '/income — pendapatan + grafik',
+  '/status — full dashboard',
+  '/balance — OTWN + Candy + Chip balances',
+  '/daily — daily report',
+  '/income — earnings + chart',
   '',
   '💰 <b>Wallet & Bank</b>',
   '/wallet — info wallet + on-chain',
-  '/wallet deposit [jumlah] — setor ke bank',
-  '/wallet withdraw [jumlah] — tarik dari bank',
+  '/wallet deposit [amount] — deposit to bank',
+  '/wallet withdraw [amount] — withdraw from bank',
   '',
   '🎮 <b>Game</b>',
-  '/inventory — isi tas + nilai',
-  '/market — harga pasar + tren',
-  '/trades — riwayat jual',
-  '/listings — listing aktif',
-  '/quest — status quest',
-  '/candy — candy + ekonomi',
+  '/inventory — bag contents + value',
+  '/market — market prices + trend',
+  '/trades — sales history',
+  '/listings — active listings',
+  '/quest — quest status',
+  '/candy — candy + economy',
   '/boss — world boss',
   '/world — live state + mobs',
   '/pvpboard — PvP leaderboard',
@@ -483,10 +483,10 @@ tg.on('help',()=>notify([
   '/health · /errors · /settings',
   '/schedule · /log [n] · /ping',
   '',
-  '<i>⚠️ 1 wallet = 1 sesi. /stop untuk main manual.</i>',
+  '<i>⚠️ 1 wallet = 1 session. Use /stop for manual play.</i>',
 ].join('\n')));
 tg.on('start',()=>{paused=false;stopped=false;if(connected){notify('▶️ Already farming.');return}notify('🚀 Connecting…');startBot()});
-tg.on('stop',()=>{stopped=true;paused=false;if(retryTimer){clearTimeout(retryTimer);retryTimer=null}try{if(activeSocket)activeSocket.disconnect()}catch{}connected=false;notify('⏹️ <b>Stopped</b> — main manual.')});
+tg.on('stop',()=>{stopped=true;paused=false;if(retryTimer){clearTimeout(retryTimer);retryTimer=null}try{if(activeSocket)activeSocket.disconnect()}catch{}connected=false;notify('⏹️ <b>Stopped</b> — manual mode.')});
 tg.on('status',()=>{const p=getProfitSummary(),up=fmtUptime(Date.now()-stats.startTime),alive=liveMonsters.filter(m=>m.alive).length;notify([`${connected?'🟢':'🔴'} <b>OWNTOWN v25</b> · ${paused?'⏸️':stopped?'⏹️':connected?'▶️ '+currentActivity:'⏳'}`,`<i>⏱${up} · 📍${zoneName} · Lv${level} (${stats.xp}/${stats.xpForNext||'?'}XP)</i>`,'','💰 <b>Economy</b>',`<pre>Balance  ${fmt(Math.round(balance))} OTWN\nCandy    ${fmt(candyBalance)}\nChip     ${fmt(chipBalance)}\nBank     ${fmt(stats.bankBalance)}\nEarned   ${fmt(p.totalEarned)} · ${fmt(p.rate)}/h</pre>`,'',`🧍 ❤️${hp}/${maxHp} ⚡${stamina} 📦${inventory.length}/${CARRY_CAP}`,`⛏${fmt(stats.mined)} 🎣${fmt(stats.fished)} ⚔${fmt(stats.kills)} 🔨${fmt(stats.crafted)} 👹${fmt(stats.bossClaims)}`,`🌍 ${serverPlayerCount} online · ${alive}/${liveMonsters.length} mobs · boss:${worldBossState?.phase||'?'}`,`📜 Quest: ${questState?.activeId||'none'} (${(questState?.completed||[]).length} done)`,`${stats.errors?'⚠️':'✅'} err:${stats.errors} reconn:${stats.reconnects||0}`].join('\n'))});
 tg.on('stats',()=>tg.handlers['status']());
 tg.on('balance',()=>notify(`💰 <b>Balance</b>\n<pre>OTWN     ${fmt(Math.round(balance))}\nLocked   ${fmt(lockedBalance)}\nCandy    ${fmt(candyBalance)} 🍬\nChip     ${fmt(chipBalance)} 🎰\nBank     ${fmt(stats.bankBalance)}\nDaily    ${fmt(dailyEarned)} / ${DAILY_EARN_CAP||'∞'}</pre>`));
@@ -507,7 +507,7 @@ tg.on('wallet',async(args)=>{
     return;
   }
   if(sub==='withdraw'&&amount>0){
-    if(!bankInfo||bankInfo.withdrawable<amount){notify(`⚠️ Withdrawable: ${fmt(bankInfo?.withdrawable||0)} OTWN (butuh ${amount})\nMin withdraw server: ${fmt(wdMin)}`);return}
+    if(!bankInfo||bankInfo.withdrawable<amount){notify(`⚠️ Withdrawable: ${fmt(bankInfo?.withdrawable||0)} OTWN (need ${amount})\nServer minimum withdraw: ${fmt(wdMin)}`);return}
     if(activeSocket)activeSocket.emit('bank:withdraw',{amount});
     const fee=Math.round(amount*wdFee);
     notify(`🏦 <b>Withdrawing</b> ${fmt(amount)} OTWN (fee ~${fee})…\n<i>Min server: ${fmt(wdMin)} — server will confirm or reject</i>`);

install.sh

@@ -3,7 +3,7 @@
 #  RY GROUP — Owntown Farming Bot — One-line Installer
 #  Usage (one-liner):
 #    bash <(curl -fsSL https://raw.githubusercontent.com/rygroup-dev/owntown-farming-bot/main/install.sh)
-#    OWNTOWN_REF=v25.0.1 bash <(curl -fsSL https://raw.githubusercontent.com/rygroup-dev/owntown-farming-bot/main/install.sh)
+#    OWNTOWN_REF=v25.0.2 bash <(curl -fsSL https://raw.githubusercontent.com/rygroup-dev/owntown-farming-bot/main/install.sh)
 #  Non-interactive (pass secrets up front):
 #    WALLET_PRIVATE_KEY=xxx TELEGRAM_BOT_TOKEN=yyy bash <(curl -fsSL .../install.sh)
 # ============================================================

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "owntown-farmer",
-  "version": "25.0.1",
+  "version": "25.0.2",
   "description": "Full-featured automated farming bot for Owntown.fun — mining, fishing, combat, PvP, property, marketplace, bank, crafting",
   "main": "bot.js",
   "scripts": {

package.json

@@ -64,8 +64,8 @@ class Telegram {
     };
     const res = await tgApi(this.token, 'sendMessage', body);
     if (!res.ok) {
-      // Server/game error kadang bawa HTML mentah (mis. <!doctype ...>).
-      // Fallback ke plain text biar command tidak diam.
+      // Some upstream failures include raw HTML (for example <!doctype ...>).
+      // Retry in plain text so the command never fails silently.
       const fallback = { ...body, text: toPlainTelegramText(text) };
       delete fallback.parse_mode;
       const retry = await tgApi(this.token, 'sendMessage', fallback);

telegram.js

@@ -23,7 +23,7 @@ test('main source files pass node syntax check', () => {
 test('package metadata matches project identity', () => {
   const pkg = JSON.parse(fs.readFileSync(path.join(ROOT, 'package.json'), 'utf8'));
   assert.equal(pkg.name, 'owntown-farmer');
-  assert.equal(pkg.version, '25.0.1');
+  assert.equal(pkg.version, '25.0.2');
 });
 
 test('telegram command handlers match documented command surface', () => {