ami_rebitay

این ساختی دیگه؟

🔐 Secure Vault

AM | Development — Rare Project

Minecraft Version: 1.21.8 Server: Paper

---

🎯 هدف پلاگین

یک سیستم Vault شخصی و امن برای بازیکنان SMP ساخته شود که هر بازیکن بتواند آیتم‌های خود را داخل یک انبار اختصاصی ذخیره کند.

دسترسی اصلی:

/vault

---

📦 سیستم Vault

هر بازیکن یک Vault اختصاصی داشته باشد.

بازیکن بتواند:

  • آیتم داخل Vault قرار دهد.
  • آیتم از Vault بردارد.
  • آیتم‌ها را جابه‌جا کند.
  • Vault را ببندد و بعداً دوباره باز کند.
  • آیتم‌ها بعد از Restart سرور باقی بمانند.
  • هیچ بازیکن دیگری به Vault او دسترسی نداشته باشد.

---

🖥️ GUI

Vault به صورت یک Inventory GUI باز شود.

عنوان:

🔐 Secure Vault

GUI قابل تنظیم باشد و تعداد Slotها از Config تعیین شود.

مثلاً:

  • 27 Slot
  • 54 Slot

رنگ و ظاهر GUI نیز قابل تغییر باشد.

---

👑 محدودیت Rank

تعداد Vault یا ظرفیت Vault بر اساس Permission قابل تنظیم باشد.

مثلاً:

securevault.vault.1

securevault.vault.2

securevault.vault.3

Admin بتواند در Config مشخص کند هر Permission چه مقدار ظرفیت داشته باشد.

---

💾 ذخیره‌سازی

اطلاعات Vault بعد از Restart یا Reload از بین نرود.

حداقل یکی از این Storageها استفاده شود:

  • SQLite
  • YAML

ترجیحاً SQLite استفاده شود.

---

🔒 امنیت

پلاگین باید جلوی موارد زیر را بگیرد:

  • دسترسی بازیکن دیگر به Vault
  • از بین رفتن آیتم‌ها هنگام بسته شدن GUI
  • Duplicate شدن آیتم‌ها
  • انتقال غیرمجاز Item
  • سوءاستفاده هنگام Reload/Restart
  • باز کردن همزمان یک Vault توسط چند نفر

در صورت خطا، آیتم‌های بازیکن نباید از بین بروند.

---

👮 Admin Commands

/vault <player>

برای مشاهده Vault بازیکن توسط Staff.

Permission:

securevault.admin

همچنین:

/vault reload

برای Reload کردن Config.

Permission:

securevault.reload

---

⚙️ Config

موارد زیر قابل تنظیم باشند:

  • نام GUI
  • تعداد Slot
  • Permissionها
  • پیام‌ها
  • Storage
  • اجازه دسترسی Admin
  • فعال/غیرفعال بودن قابلیت‌های مختلف

---

💬 پیام‌ها

تمام پیام‌های پلاگین داخل Config باشند.

مثلاً:

&cYou don't have permission.

&aVault opened successfully.

&cThis vault is currently being used.

---

🛡️ قوانین مهم

  • /vault فقط در صورت داشتن Permission کار کند.
  • بازیکن فقط Vault خودش را ببیند.
  • هنگام باز شدن Vault، Inventory بازیکن به درستی مدیریت شود.
  • آیتم‌ها با Restart سرور باقی بمانند.
  • هیچ Item Dupe وجود نداشته باشد.
  • پلاگین بدون وابستگی اضافی کار کند.
  • تمام قابلیت‌ها در Paper 1.21.8 تست شوند.

---

📌 خروجی نهایی

سازنده باید تحویل دهد:

SecureVault.jar config.yml README / توضیحات نصب Permission List Command List

پلاگین باید با Paper 1.21.8 - 1.21 سازگار باشد و قبل از تحویل روی یک سرور واقعی تست شود. این پلاگین بساز به اسم AM Valut سازنده: AM Development | ami\_Rebitay و پیام روشن شدن با اسم من و خاموش شدن AM | Development Your idea, our code.

Kodari AI
KodariSep 6 at 6:13 pm 2
AMSecureVault
A secure personal vault plugin with GUI-based storage for Minecraft Paper servers. Each player gets a private vault accessible via /vault command, with configurable slot counts based on permissions. Features SQLite persistence for items across restarts, admin inspection commands, reload support, and comprehensive security measures preventing unauthorized access, item duplication, and data loss. Fully customizable GUI appearance, messages, and permissions through config.yml. Supports Paper 1.21-1.21.8 with no external dependencies.
  • ساخت هسته پلاگین Paper 1.21.8 با نام AMValut و پیام‌های برند AM Development

  • پیاده‌سازی Vault امن با ظرفیت وابسته به Permission، قفل هم‌زمان و دسترسی Admin

  • ذخیره‌سازی پایدار YAML اتمیک بدون وابستگی خارجی، همراه با recovery در خطای ذخیره

  • افزودن Config، Command/Permission، README و فایل‌های Gradle برای ساخت JAR

بله، پروژه AM Valut ساخته شد.

ویژگی‌های پیاده‌سازی‌شده:

  • /vault برای Vault اختصاصی هر بازیکن

  • /vault <player> برای Staff با Permission

  • /vault reload

  • ظرفیت‌های 27، 36 و 54 Slot بر اساس Permission

  • جلوگیری از باز شدن هم‌زمان یک Vault

  • جلوگیری از دسترسی غیرمجاز و Interaction تقلبی

  • ذخیره‌سازی دائمی YAML در مسیر: plugins/AMValut/vaults/<uuid>.yml

  • ذخیره‌سازی امن با فایل موقت و Recovery

  • حفظ آیتم‌های Slotهای مخفی در صورت کاهش Rank

  • Admin View به‌صورت Read-Only به‌صورت پیش‌فرض

  • Config کامل برای عنوان، ظرفیت، Permission و پیام‌ها

  • پیام روشن و خاموش شدن با برند:

Plain Text
AM | Development
Your idea, our code.

فایل خروجی Gradle:

Plain Text
build/libs/AM-Valut.jar

برای ساخت:

Shell
gradle build

سازنده در plugin.yml:

Plain Text
ami_Rebitay

نام پلاگین:

Plain Text
AMValut
Kodari can make mistakes. Review important code before using.
Files
src
build.gradle
README.md
settings.gradle
Code
13 842
src/main/java/me/amdevelopment/amvalut/AMValut.java
package me.amdevelopment.amvalut;

import org.bukkit.Bukkit;
import org.bukkit.ChatColor;
import org.bukkit.command.PluginCommand;
import org.bukkit.plugin.java.JavaPlugin;

public final class AMValut extends JavaPlugin {

    private VaultStorage storage;
    private VaultManager vaultManager;
    private MessageService messages;

    @Override
    public void onEnable() {
        saveDefaultConfig();

        this.messages = new MessageService(this);
        this.storage = new VaultStorage(this);
        this.vaultManager = new VaultManager(this, storage, messages);

        VaultCommand vaultCommand = new VaultCommand(this, vaultManager, messages);
        PluginCommand command = getCommand("vault");
        if (command != null) {
            command.setExecutor(vaultCommand);
            command.setTabCompleter(vaultCommand);
        }

        Bukkit.getPluginManager().registerEvents(new VaultListener(vaultManager), this);
        logConfiguredLines("startup");
    }

    @Override
    public void onDisable() {
        if (vaultManager != null) {
            vaultManager.shutdown();
        }
        logConfiguredLines("shutdown");
    }

    public void reloadPluginConfig() {
        reloadConfig();
    }

    private void logConfiguredLines(String key) {
        for (String line : getConfig().getStringList("messages." + key)) {
            String colored = ChatColor.translateAlternateColorCodes('&', line);
            getLogger().info(ChatColor.stripColor(colored));
        }
    }
}