إعداد Ollama لـ Verity Mod

دليل إعداد Ollama لـ Verity Mod — تثبيت Ollama، تحميل الموديل المناسب، وإعداد الاتصال لـ Verity JE. كل شي تحتاجه عشان الذكاء الاصطناعي يشتغل.

Verity مو مثل باقي المودات — عنده عقل ذكاء اصطناعي حقيقي يشتغل على جهازك مباشرة عبر Ollama. محادثات فعلية مو كلام مسجل مسبقاً. بس هذا يعني إن فيه خطوة إضافية لازم تسويها قبل ما تستمتع فيه.

لو تجاهلت هالخطوة، Verity بيكون موجود بس ما بيتكلم. ساكت بالتمام.

وش يسوي Ollama أصلاً؟

Ollama برنامج مجاني ومفتوح المصدر يشغل نماذج الذكاء الاصطناعي على جهازك. هو المحرك اللي يعطي Verity صوته وشخصيته. لما تتكلم مع Verity داخل اللعبة، المحادثة تمر عبر Ollama على جهازك — ما يطلع شي خارج جهازك، وما يرسل شي لسيرفرات خارجية.

ميزتين أساسيتين:

الخصوصية — محادثاتك تبقى على جهازك بس
السرعة — ما تنتظر ردود من سيرفر بعيد

متطلبات النظام

المكون	الحد الأدنى	الموصى به
نظام التشغيل	Windows 10, macOS 12, Ubuntu 20.04	آخر نسخة مستقرة
الرام	8 GB إجمالي (4 للماين + 4 لـ Ollama)	16 GB إجمالي
المساحة	~5 GB فاضي (الموديل + Ollama)	10+ GB فاضي
كرت الشاشة	مو ضروري (يشتغل على المعالج)	NVIDIA بـ 4+ GB VRAM

يشتغل على المعالج بس — لكن أبطأ طبعاً. لو عندك كرت NVIDIA بـ 4 جيجا VRAM أو أكثر، الردود بتصير أسرع بكثير. وماكات Apple Silicon (M1/M2/M3/M4) تشتغل كويس لأن الرام موحدة بين المعالج والكرت.

الخطوة ١ — تثبيت Ollama

تحميل Ollama

Windows

١. حمّل المثبّت من ollama.com/download ٢. شغّل ملف .exe واتبع الخطوات ٣. بيتثبت في %LOCALAPPDATA%\Programs\Ollama ويضيف نفسه للـ PATH ٤. يشتغل تلقائياً — بتلاقي أيقونة Ollama في شريط المهام

macOS

١. حمّله من ollama.com/download ٢. افتح .dmg واسحب Ollama للـ Applications ٣. شغّله مرة وحدة — وبيشتغل كخدمة بالخلفية

Linux

١. شغّل أمر التثبيت من ollama.com:

curl -fsSL https://ollama.com/install.sh | sh

٢. بيضبط Ollama كخدمة systemd ٣. تأكد إنه شغال:

ollama --version

الخطوة ٢ — تحميل موديل Verity

هذي الخطوة اللي أغلب الناس تنساها. Ollama ما يجي مع الموديل اللي يحتاجه Verity — لازم تحمّله لحالك.

اسم الموديل بالضبط موجود بصفحة المشروع على CurseForge وصفحة Modrinth. روح لهم أول شي — الموديل ممكن يتغير بين نسخ Verity، فاسم من فيديو يوتيوب قديم ممكن يكون غلط.

لما تعرف الاسم:

ollama pull <model-name>

مثلاً لو صفحة المشروع تقول llama3.2:

ollama pull llama3.2

التحميل عادة ٢-٥ جيجا. خلّصه قبل ما تفتح ماينكرافت.

تأكد إن الموديل اتثبت

ollama list

لازم تشوف الموديل بالقائمة. ما لقيته؟ يعني التحميل ما كمل — شغّل الأمر مرة ثانية.

الخطوة ٣ — شغّل Ollama قبل ما تلعب

Ollama لازم يكون شغال وانت تلعب.

Windows: أيقونة Ollama بشريط المهام = تمام. لو مو موجودة، دور على “Ollama” بـ Start وشغّله.

macOS: أيقونة شريط القوائم = تمام.

Linux:

sudo systemctl start ollama

تأكد إن Ollama شغال

curl http://localhost:11434/api/tags

جاوبك JSON فيه الموديلات = جاهز. “Connection refused” = مو شغال — شغّله.

الخطوة ٤ — شغّل ماينكرافت مع Verity

١. Ollama شغال (الخطوة ٣) ٢. شغّل بروفايل Forge/NeoForge اللي حطيت فيه Verity ٣. ادخل عالم — Verity لازم يظهر ويبدأ يتكلم

Verity موجود بس ما يرد؟ المود ما يوصل لـ Ollama. تحقق:

Ollama شغال؟ (curl http://localhost:11434/api/tags)
الموديل الصحيح محمّل؟ (ollama list)
فيه شي يسد port 11434؟ (جدار نار، مضاد فايروسات)

مشاكل شائعة

”Ollama not found” أو “connection refused”

مو شغال. شغّله قبل ما تفتح ماينكرافت.

Verity يظهر بس ما يتكلم

الموديل ما اتحمّل. ollama list — لو موديل Verity مو موجود، سوّي ollama pull <model-name> مرة ثانية.

الردود بطيئة مرة

يشتغل على المعالج مع موديل كبير. خياراتك:

استخدم موديل أصغر لو صفحة المشروع فيها بدائل
قفل التطبيقات اللي تاخذ رام ومعالج
عندك كرت NVIDIA؟ تأكد إن Ollama يستخدمه (Task Manager → شوف استخدام الكرت لما Verity يرد)

خطأ “Model not found”

اسم الموديل بإعدادات Verity ما يطابق اللي حمّلته. تحقق: ١. وش الموديل اللي Verity يبي — .minecraft/config/verity/ أو صفحة المشروع ٢. وش الموديل اللي عندك — ollama list ٣. لازم يطابق بالضبط

Port 11434 مستخدم من برنامج ثاني

شي ثاني يستخدم بورت Ollama الافتراضي. تحقق:

# Windows (PowerShell)
netstat -ano | findstr :11434

# macOS / Linux
lsof -i :11434

نسخة Ollama ثانية شغّالة؟ قفلها. شي ثاني على هالبورت؟ غيّر بورت Ollama — شوف وثائق Ollama.

نصايح

خلّ Ollama شغال — قفله وفتحه بين الجلسات عادي، بس لازم يكون شغال وانت تلعب
ما تحدثه Ollama بدون ما تقرأ — التحديثات الكبيرة أحياناً تغير صيغة الموديلات. لو Verity توقف عن الشغل بعد تحديث Ollama، روح لصفحة المشروع وشوف ملاحظات التوافق
حجم الموديل مهم — موديلات أكبر = ردود أذكى بس تاخذ رام أكثر وأبطأ. اطلب اللي تنصح فيه صفحة المشروع
أول رد دايم بطيء — Ollama يحمّل الموديل بالرام بأول طلب. بعدها يصير أسرع

دليل التثبيت الكامل

شرح مفصل من ماينكرافت نظيف لـ Verity يشتغل.

Java Edition

تفاصيل إعداد Forge و NeoForge، плюс إعدادات Ollama.

حل المشاكل

في مشكلة ثانية؟ حلّها من هنا.

موقع مستقل — مو تابع أو معتمد من Mojang أو Microsoft أو ThatMob أو Ollama أو CurseForge أو Modrinth.

التكوين المتقدم

النماذج المخصصة

أنشئ نموذجاً مخصصاً بشخصية محددة:

# أنشئ Modelfile
cat > VerityCustom <<EOF2
FROM llama3.1:8b
SYSTEM "You are Verity, a helpful AI companion in Minecraft. Keep responses brief and friendly."
PARAMETER temperature 0.7
PARAMETER num_ctx 2048
EOF2

# ابنِ النموذج المخصص
ollama create verity-custom -f VerityCustom

# استخدم في Minecraft
# قم بتعيين ollama_model = "verity-custom" في التكوين

نماذج متعددة

بدّل بين النماذج بسهولة:

# قم بتنزيل نماذج متعددة
ollama pull llama3.1:8b
ollama pull mistral:7b
ollama pull codellama:7b

# سرد جميع النماذج
ollama list

# بدّل في تكوين Minecraft
# فقط غيّر إعداد ollama_model

تكوين الشبكة

تغيير منفذ Ollama:

# قم بتعيين منفذ مخصص
export OLLAMA_HOST=0.0.0.0:8080
ollama serve

ثم قم بتحديث تكوين Minecraft:

ollama_url = "http://localhost:8080"

السماح بالاتصالات البعيدة:

# اسمح بالاتصالات من أجهزة أخرى
export OLLAMA_HOST=0.0.0.0:11434
ollama serve

استكشاف الأخطاء وإصلاحها

خطأ: “Connection refused”

السبب: خدمة Ollama لا تعمل

الحل:

# ابدأ Ollama
ollama serve

# أو في Linux
systemctl start ollama

خطأ: “Model not found”

السبب: اسم النموذج لا يتطابق

الحل:

# سرد النماذج المتاحة
ollama list

# قم بتحديث التكوين بالاسم الدقيق للنموذج
# مثال: llama3.1:8b (ليس llama3.1 أو llama3)

خطأ: “Timeout”

السبب: النموذج كبير جداً أو النظام بطيء جداً

الحل:

استخدم نموذجاً أصغر: ollama pull llama3.2:3b
قم بزيادة المهلة في التكوين: ollama_timeout = 60000
أغلق تطبيقات الخلفية
خصص المزيد من RAM لـ Minecraft

مشكلة: استجابات بطيئة جداً

السبب: يعمل على CPU بدلاً من GPU

الحل:

تحقق من GPU: nvidia-smi (يجب أن تظهر عملية ollama)
قم بتحديث برامج تشغيل GPU
قم بتعيين طبقات GPU: export OLLAMA_GPU_LAYERS=99
استخدم نموذجاً أصغر

مشكلة: أخطاء نفاد الذاكرة

السبب: النموذج كبير جداً مقارنة بـ RAM المتاحة

الحل:

استخدم نموذجاً أصغر
أغلق تطبيقات الخلفية
قم بزيادة مساحة التبديل في النظام (Linux)
قم بترقية RAM

تحسين الأداء

تسريع GPU (NVIDIA)

إذا كان لديك GPU من NVIDIA، فسيستخدمه Ollama تلقائياً. تحقق:

# تحقق من استخدام GPU
nvidia-smi

يجب أن ترى عملية ollama تستخدم ذاكرة GPU.

فرض استخدام GPU

إذا كان Ollama لا يستخدم GPU:

# قم بتعيين متغير البيئة (Linux/macOS)
export OLLAMA_GPU_LAYERS=99

# Windows PowerShell
$env:OLLAMA_GPU_LAYERS="99"
ollama serve

التحسين للأنظمة منخفضة المواصفات

تقليل حجم النموذج:

ollama pull llama3.2:3b

تقييد نافذة السياق: في .minecraft/config/verity.toml:

ollama_max_tokens = 100  # استجابات أقصر
ollama_temperature = 0.5  # معالجة أقل

إغلاق تطبيقات الخلفية:

متصفحات الويب (خاصة Chrome)
مشغلات الفيديو
ألعاب أخرى

التحسين للأنظمة عالية المواصفات

استخدام نموذج أكبر:

ollama pull llama3.1:70b

زيادة السياق:

ollama_max_tokens = 300  # استجابات أطول
ollama_temperature = 0.8  # أكثر إبداعاً

تمكين البث:

ollama_stream = true  # أظهر الاستجابة أثناء إنشائها

المقارنة: Ollama مقابل Ollama

الميزة	Ollama (محلي)	Ollama (سحابي)
الخصوصية	كاملة	يتم إرسال البيانات إلى السحابة
الإنترنت	غير مطلوب	مطلوب
التكلفة	مجاني	طبقة مجانية، ثم مدفوع
السرعة	⚡ يعتمد على الأجهزة	⚡⚡⚡ سريع جداً
الجودة	جيد	ممتاز
الإعداد	معقد	بسيط
الموثوقية	متاح دائماً	⚠️ انقطاع API ممكن
التخصيص	تحكم كامل	محدود