README.md

# sayed-bot-model-v3

Decision Transformer v3 for Sayed Bot — Full Minecraft Coverage

## Model
- **Architecture:** Transformer Encoder (8 layers, 8 heads, 512 dim)
- **Input:** `[batch, 50, 40]` — آخر 50 خطوة
- **Output:** `[batch, 25]` — logits لكل action
- **Features (40):** البيئة, البلوكات, المخزون, الدروع, الموارد, الاجتماعية
- **Actions (25):** بناء, بقاء, اجتماعي, حركة, قتال, تعدين, زراعة
- **Training data:** 5 سيناريوهات واقعية (بداية, استكشاف, خطر/بناء, اجتماعي, بناء متطور)
- **Accuracy:** 3.17%
- **Size:** ~35 MB (INT8 quantized)
- **Trained:** 2026-06-25T15:48:12Z

## Usage
```javascript
const { BotModel } = require('./bot-model');
const model = new BotModel();
await model.loadFromHF('SAyyeedd', 'sayed-bot-model-v3');
const state = model.extractState(bot);
const actionIdx = model.predict(state);
const actionName = ['IDLE','FIGHT','FLEE','MINE','FARM','COLLECT','EXPLORE','CRAFT','CHAT','FOLLOW',
  'PLACE_BLOCK','BUILD_SHELTER','LIGHT_AREA','EAT','SLEEP',
  'GO_HOME','EQUIP_ARMOR','SMELT','JUMP','SNEAK',
  'SWIM','EMOTE','WANDER','HELP_ALLY','TRADE'][actionIdx];
```

## Files
- [bot_model.onnx](https://huggingface.co/SAyyeedd/sayed-bot-model-v3/resolve/main/bot_model.onnx)
- [config.json](https://huggingface.co/SAyyeedd/sayed-bot-model-v3/resolve/main/config.json)
- [best_model.pt](https://huggingface.co/SAyyeedd/sayed-bot-model-v3/resolve/main/best_model.pt) (PyTorch weights)