ابي بلوقن ماينكرافت
[Generation stopped]
ابي بلوقن ماينكرافت يشتغل docker image java24 وفايدة البلوقن ذا يشغل vsync on للمستخدمين البيدروك
إنشاء هيكل Paper/Gradle يستهدف Java 24 ويحتوي على Dockerfile للبناء.
إضافة كشف لاعبي Bedrock عبر Floodgate وإرسال تذكير VSync تلقائياً.
إضافة أوامر الإدارة وملف الإعدادات والتوثيق، مع توضيح قيد VSync من جهة السيرفر.
تم إنشاء بلوقن BedrockVSync يعمل مع Paper وJava 24.
يتعرف تلقائياً على لاعبي Bedrock عبر Floodgate.
يرسل لهم تذكيراً بتفعيل VSync من إعدادات اللعبة.
يحتوي على أوامر:
/bedrockvsync check/bedrockvsync status <player>/bedrockvsync reload
تم إضافة
Dockerfileللبناء باستخدام Java 24.تم إضافة إعدادات ورسائل عربية قابلة للتعديل.
مهم: لا يستطيع بلوقن السيرفر تفعيل VSync فعلياً داخل جهاز اللاعب، لأن إعدادات الرسوميات محلية ولا يسمح Minecraft/Floodgate بتعديلها عن بُعد. البلوقن يكتشف لاعب Bedrock ويرسل له التوجيه المناسب.
خله على docker 25
تحديث صور Docker إلى Java 25 للبناء والتشغيل.
تحديث إعدادات Gradle وREADME لتستهدف Java 25 بدل Java 24.
تم تحديث المشروع ليعمل على Java 25:
Docker build image:
gradle:8.14-jdk25Docker runtime image:
eclipse-temurin:25-jreGradle toolchain و
options.release: Java 25تحديث متطلبات وتعليمات README إلى Java 25
ابي البلوقن ملف .jar وش الحل
لبناء ملف .jar استخدم هذه الأوامر من داخل مجلد المشروع:
docker build -t bedrock-vsync .
docker run --rm --entrypoint cat bedrock-vsync /output/BedrockVSync.jar > BedrockVSync.jar
بعدها ستجد الملف:
BedrockVSync.jar
ضعه في:
plugins/
داخل خادم Paper، ثم شغّل الخادم باستخدام Java 25.
للتأكد:
ls -lh BedrockVSync.jar
وفي Windows PowerShell يعمل نفس الأمر غالباً:
docker build -t bedrock-vsync .
docker run --rm --entrypoint cat bedrock-vsync /output/BedrockVSync.jar > BedrockVSync.jar
بدون Docker، إذا كان Gradle وJava 25 مثبتين:
gradle clean build
وسيكون الملف داخل:
build/libs/BedrockVSync-1.0.0.jar
ثم أعد تسميته أو انسخه إلى مجلد plugins.
أنا جوال
الحل الأسهل من الجوال: أضيف لك GitHub Actions يبني ملف .jar تلقائياً على السحابة، وبعدها تحمله من صفحة المشروع بدون Docker أو كمبيوتر.
تقدر تطلع ملف .jar من الجوال بدون Docker:
ارفع المشروع إلى GitHub.
افتح تبويب Actions.
اختر Build plugin.
اضغط Run workflow.
انتظر انتهاء البناء.
افتح العملية الأخيرة، ثم انزل إلى Artifacts.
حمّل
BedrockVSync.zipوفك الضغط عنه.ضع ملف
BedrockVSync.jarداخل مجلد السيرفر:
plugins/BedrockVSync.jar
أضفت ملف GitHub Actions الذي يبني البلوقن تلقائياً باستخدام Java 25.
ياخي اشرح شي اسهل
أسهل حل من الجوال:
افتح رابط مشروعك في GitHub.
اضغط تبويب Actions.
اختر Build plugin.
اضغط Run workflow ثم Run workflow مرة ثانية.
انتظر حتى تظهر علامة ✅.
افتح العملية الناجحة.
انزل إلى Artifacts واضغط: BedrockVSync
حمّل الملف وفك الضغط عنه.
خذ ملف:
BedrockVSync.jar
ارفعه إلى مجلد:
plugins
في استضافتك.
إذا ما عندك مشروع على GitHub، أرسل لي رابط المشروع أو ارفع ملفاته، لأن ملف الـ.jar لا يمكن استخراجه من الجوال مباشرة بدون خدمة بناء مثل GitHub Actions.
وين actions?
في موقع GitHub وليس داخل الجوال أو ملفات المشروع:
افتح مشروعك في GitHub من المتصفح.
في أعلى صفحة المشروع ستجد التبويبات: Code — Issues — Pull requests — Actions
اضغط Actions.
إذا لم يظهر تبويب Actions:
تأكد أنك داخل صفحة المستودع وليس صفحة الحساب.
افتح GitHub من Chrome، واضغط ⋮ ثم فعّل عرض سطح المكتب.
تأكد أن ملف البناء موجود هنا داخل المشروع:
.github/workflows/build.yml
إذا مشروعك غير مرفوع على GitHub أصلاً، فلن يظهر Actions. تحتاج أولاً إنشاء مستودع ورفع ملفات البلوقن إليه.
طيب في البي سي في طريقه اسهل؟
نعم، على الكمبيوتر أسهل:
إذا عندك المشروع على الكمبيوتر
افتح مجلد المشروع.
اضغط بزر الفأرة الأيمن داخل المجلد واختر Open in Terminal.
اكتب:
gradle clean build
ستجد ملف البلوقن هنا:
build/libs/BedrockVSync-1.0.0.jar
ارفع ملف
.jarإلى مجلد:
plugins
في سيرفر Paper.
إذا ظهر أن gradle غير معروف
استخدم Docker Desktop، ثم افتح التيرمنال داخل مجلد المشروع واكتب:
docker build -t bedrock-vsync .
docker run --rm --entrypoint cat bedrock-vsync /output/BedrockVSync.jar > BedrockVSync.jar
سيظهر الملف مباشرة داخل مجلد المشروع باسم:
BedrockVSync.jar
الطريقة الأسهل فعلياً: إذا كان Docker مثبتاً عندك، استخدم أوامر Docker؛ لا تحتاج تثبيت Java أو Gradle يدوياً.
? وين terminal
أنت الآن ضاغط على ملف ZIP. اتبع التالي:
اضغط بزر الفأرة الأيمن على الملف المحدد.
اختر Extract All… / استخراج الكل.
اضغط Extract.
افتح المجلد الذي ظهر.
داخل المجلد، اضغط على شريط العنوان في الأعلى — المكان الذي يظهر فيه مسار المجلد.
اكتب:
powershell
اضغط Enter.
ستفتح نافذة زرقاء اسمها PowerShell، وهي الـ Terminal.
إذا كان Docker مثبتاً، اكتب فيها:
docker build -t bedrock-vsync .
docker run --rm --entrypoint cat bedrock-vsync /output/BedrockVSync.jar > BedrockVSync.jar
سيظهر ملف:
BedrockVSync.jar
داخل نفس المجلد.
إذا لم يكن Docker مثبتاً، لا تستخدم الأوامر السابقة؛ أرسل صورة لما داخل المجلد بعد فك الضغط، وسأعطيك الطريقة المناسبة.
Windows PowerShell Copyright (C) Microsoft Corporation. All rights reserved.
Install the latest PowerShell for new features and improvements! https://aka.ms/PSWindows
PS C:\Users\Pc\Downloads\BedrockVsyncEnforcer-1786806192912> powershell Windows PowerShell Copyright (C) Microsoft Corporation. All rights reserved.
Install the latest PowerShell for new features and improvements! https://aka.ms/PSWindows
PS C:\Users\Pc\Downloads\BedrockVsyncEnforcer-1786806192912>
ممتاز، أنت الآن داخل المجلد الصحيح ✅
لا تكتب powershell مرة ثانية.
نفّذ هذا الأمر:
docker build -t bedrock-vsync .
انتظر حتى يكتمل البناء، ثم نفّذ:
docker run --rm --entrypoint cat bedrock-vsync /output/BedrockVSync.jar > BedrockVSync.jar
بعدها ستجد الملف داخل نفس المجلد:
BedrockVSync.jar
إذا ظهر لك خطأ مثل:
docker is not recognized
فهذا يعني أن Docker غير مثبت أو غير مفتوح. افتح Docker Desktop أولاً، ثم أعد الأوامر.
docker : The term 'docker' is not recognized as the name of a cmdlet, function, script file, or operable program.
Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1 + docker build -t bedrock-vsync . + ~~~~~~ + CategoryInfo : ObjectNotFound: (docker:String) [], CommandNotFoundException + FullyQualifiedErrorId : CommandNotFoundException
الخطأ يعني أن Docker غير مثبت. اترك Docker، واستخدم Gradle الموجود داخل المشروع إن وُجد.
في نفس النافذة اكتب:
dir
ابحث عن ملف اسمه:
gradlew.bat
إذا ظهر، نفّذ:
.\gradlew.bat clean build
بعد انتهاء العملية اكتب:
dir build\libs
ستجد ملف البلوقن داخل مجلد:
build\libs
إذا لم يظهر gradlew.bat، انسخ نتيجة أمر dir هنا، وسأعطيك الأمر الصحيح مباشرة.
Mode LastWriteTime Length Name ---- ------------- ------ ---- d----- 8/15/2026 8:05 AM .github d----- 8/15/2026 8:05 AM src -a---- 8/15/2026 8:05 AM 31 .dockerignore -a---- 8/15/2026 8:05 AM 612 build.gradle -a---- 8/15/2026 8:05 AM 295 Dockerfile -a---- 8/15/2026 8:05 AM 1840 README.md -a---- 8/15/2026 8:05 AM 133 settings.gradle
المشروع ناقصه Gradle Wrapper، لذلك لا يوجد gradlew.bat. أسهل حل على الكمبيوتر:
في PowerShell نفّذ:
winget install --id EclipseAdoptium.Temurin.25.JDK -e
winget install --id Gradle.Gradle -e
بعد انتهاء التثبيت أغلق PowerShell وافتحه من جديد داخل مجلد المشروع، ثم اكتب:
gradle clean build
إذا انتهى بدون أخطاء، ملف البلوقن سيكون هنا:
build\libs\BedrockVSync-1.0.0.jar
ارفعه إلى:
plugins
إذا ظهر أن winget غير معروف، استخدم GitHub Actions بدل التثبيت؛ أما Docker فلا تحتاجه.
📄
pasted-code-1786806486778.txt
txt
45 lines
▶
Windows PowerShell
Copyright (C) Microsoft Corporation. All rights reserved.
Install the latest PowerShell for new features and improvements! https://aka.ms/PSWindows
PS C:\Users\Pc\Downloads\BedrockVsyncEnforcer-1786806192912> powershell
Windows PowerShell
Copyright (C) Microsoft Corporation. All rights reserved.
Install the latest PowerShell for new features and improvements! https://aka.ms/PSWindows
PS C:\Users\Pc\Downloads\BedrockVsyncEnforcer-1786806192912> docker build -t bedrock-vsync .
docker : The term 'docker' is not recognized as the name of a cmdlet, function, script file, or operable program.
Check the spelling of the name, or if a path was included, verify that the path is correct and try again.
At line:1 char:1
+ docker build -t bedrock-vsync .
+ ~~~~~~
+ CategoryInfo : ObjectNotFound: (docker:String) [], CommandNotFoundException
+ FullyQualifiedErrorId : CommandNotFoundException
PS C:\Users\Pc\Downloads\BedrockVsyncEnforcer-1786806192912> dir
Directory: C:\Users\Pc\Downloads\BedrockVsyncEnforcer-1786806192912
Mode LastWriteTime Length Name
---- ------------- ------ ----
d----- 8/15/2026 8:05 AM .github
d----- 8/15/2026 8:05 AM src
-a---- 8/15/2026 8:05 AM 31 .dockerignore
-a---- 8/15/2026 8:05 AM 612 build.gradle
-a---- 8/15/2026 8:05 AM 295 Dockerfile
-a---- 8/15/2026 8:05 AM 1840 README.md
-a---- 8/15/2026 8:05 AM 133 settings.gradle
PS C:\Users\Pc\Downloads\BedrockVsyncEnforcer-1786806192912> winget install --id EclipseAdoptium.Temurin.25.JDK -e
The `msstore` source requires that you view the following agreements before using.
Terms of Transaction: https://aka.ms/microsoft-store-terms-of-transaction
The source requires the current machine's 2-letter geographic region to be sent to the backend service to function properly (ex. "US").
Do you agree to all the source agreements terms?
[Y] Yes [N] No:
[Y] Yes [N] No:
اكتب الآن:
Y
ثم اضغط Enter للموافقة.
بعد تثبيت Java، نفّذ:
winget install --id Gradle.Gradle -e
عند ظهور سؤال الموافقة اكتب أيضًا:
Y
ثم اضغط Enter.
بعد انتهاء التثبيت:
أغلق PowerShell.
افتح PowerShell من داخل مجلد المشروع مرة أخرى.
نفّذ:
gradle clean build
بعد نجاح البناء، الملف سيكون داخل:
build\libs
إذا ظهر سؤال المنطقة أو اتفاقية أخرى، اكتب Y واضغط Enter.
Found Eclipse Temurin JDK with Hotspot 25 [EclipseAdoptium.Temurin.25.JDK] Version 25.0.4.7 This application is licensed to you by its owner.
Microsoft is not responsible for, nor does it grant any licenses to, third-party packages.
Downloading https://github.com/adoptium/temurin25-binaries/releases/download/jdk-25.0.4+7/OpenJDK25U-jdk_x64_windows_hotspot_25.0.4_7.msi ██████████████████████████████ 110 MB / 110 MB Successfully verified installer hash Starting package install...
Successfully installed PS C:\Users\Pc\Downloads\BedrockVsyncEnforcer-1786806192912> winget install --id Gradle.Gradle -e No package found matching input criteria.
PS C:\Users\Pc\Downloads\BedrockVsyncEnforcer-1786806192912> winget install --id Gradle.Gradle -e No package found matching input criteria.
PS C:\Users\Pc\Downloads\BedrockVsyncEnforcer-1786806192912>
لا توجد حزمة Gradle في winget عندك، لكن Java 25 تم تثبيته بنجاح. استخدم Gradle مباشرة بدون تثبيت دائم:
أغلق PowerShell وافتحه من جديد داخل مجلد المشروع.
نفّذ الأوامر التالية بالترتيب:
java -version
ثم:
Invoke-WebRequest "https://services.gradle.org/distributions/gradle-9.1.0-bin.zip" -OutFile "$env:TEMP\gradle.zip"
Expand-Archive "$env:TEMP\gradle.zip" -DestinationPath "$env:USERPROFILE\gradle" -Force
ثم ابنِ البلوقن:
& "$env:USERPROFILE\gradle\gradle-9.1.0\bin\gradle.bat" clean build
بعد نجاح البناء، ستجد الملف هنا:
build\libs\BedrockVSync-1.0.0.jar
انسخه إلى مجلد plugins في سيرفر Paper.
لا تكتب powershell مرة أخرى؛ أنت بالفعل داخل PowerShell.
PS C:\Users\Pc\Downloads\BedrockVsyncEnforcer-1786806192912> java -version Error: could not open `C:\Program Files\Java\jre-1.8\lib\amd64\jvm.cfg' PS C:\Users\Pc\Downloads\BedrockVsyncEnforcer-1786806192912>
المشكلة أن Windows ما زال يستخدم Java القديم من هذا المسار:
C:\Program Files\Java\jre-1.8
استخدم Java 25 المثبت حديثًا في نافذة PowerShell الحالية. نفّذ الأوامر التالية:
$jdk = Get-ChildItem "C:\Program Files\Eclipse Adoptium" -Directory | Where-Object Name -like "jdk-*" | Sort-Object Name -Descending | Select-Object -First 1
$env:JAVA_HOME = $jdk.FullName
$env:Path = "$env:JAVA_HOME\bin;$env:Path"
تأكد من الإصلاح:
java -version
يجب أن يظهر إصدار Java 25.
بعدها ثبّت Gradle يدويًا:
Invoke-WebRequest "https://services.gradle.org/distributions/gradle-9.1.0-bin.zip" -OutFile "$env:TEMP\gradle.zip"
Expand-Archive "$env:TEMP\gradle.zip" -DestinationPath "$env:USERPROFILE\gradle" -Force
ثم ابنِ المشروع:
& "$env:USERPROFILE\gradle\gradle-9.1.0\bin\gradle.bat" clean build
إذا نجح البناء، ستجد ملف البلوقن داخل:
build\libs
package com.kodari.bedrockvsync;
import org.bukkit.ChatColor;
import org.bukkit.command.PluginCommand;
import org.bukkit.plugin.java.JavaPlugin;
public final class BedrockVSyncPlugin extends JavaPlugin {
private FloodgateDetector floodgateDetector;
@Override
public void onEnable() {
saveDefaultConfig();
floodgateDetector = new FloodgateDetector(getLogger());
floodgateDetector.initialize();
getServer().getPluginManager().registerEvents(
new BedrockJoinListener(this, floodgateDetector), this);
PluginCommand command = getCommand("bedrockvsync");
if (command == null) {
getLogger().severe("The bedrockvsync command is missing from plugin.yml.");
getServer().getPluginManager().disablePlugin(this);
return;
}
BedrockVSyncCommand commandHandler = new BedrockVSyncCommand(this, floodgateDetector);
command.setExecutor(commandHandler);
command.setTabCompleter(commandHandler);
}
public FloodgateDetector getFloodgateDetector() {
return floodgateDetector;
}
public String message(String key) {
String prefix = getConfig().getString("messages.prefix", "");
String message = getConfig().getString(key, key);
return color(prefix + message);
}
public String rawMessage(String key) {
return color(getConfig().getString(key, key));
}
private String color(String message) {
return ChatColor.translateAlternateColorCodes('&', message.replace("\\n", "\n"));
}
}