# آموزش نصب Paper

- پیوند: https://negarnovin.com/docs/install-paper-on-ubuntu/
- منتشرشده: 2025-09-27T10:57:59+00:00
- نویسنده: نگارنوین

# نصب 󠀁[Paper](https://negarnovin.com/encyclopedia/paper/)󠁿 در اوبونتو ۲۰.۰۴

یاد بگیرید که چگونه [Paper](https://negarnovin.com/encyclopedia/paper/) را روی اوبونتو
۲۰.۰۴ برای عملکرد و ویژگی های بهبود یافته نصب کنید. برای راه اندازی بهینه، راهنمای
گام به گام ما را دنبال کنید.

 

## مقد مه

پیپر یک انشعاب با عملکرد بالا از  اسپیگات است که برای رفع ناهماهنگی های گیم پلی 
و مکانیک طراحی شده است و ویژگی های منحصر به فرد متعدد و بهبودهای قابل توجهی در عملکرد
را ارائه می دهد که در اسپیگات موجود نیست. این راهنما شما را در مراحل نصب پیپر در
اوبونتو ۲۰.۰۴ راهنمایی می کند و تضمین می کند که می توانید آن را برای عملکرد بهینه
پیکربندی کنید. توصیه می شود `sudo`برای حفظ امنیت، تمام دستورات را به عنوان یک کاربر
غیر ریشه با امتیازات اجرا کنید.

## ۱. پیش نیازها را نصب کنید

 * یک نمونه سرور مجازی سیستم عامل اوبونتو .
 * یک کاربر sudo ایجاد کنید.
 * سرور اوبونتو را بروزرسانی کنید .

ابزارهای مورد نیاز را نصب کنید.

    ```
    $ sudo apt-get install wget apt-transport-https gnupg
    ```

کلید AdoptOpenJDK GPG را وارد کنید.

    ```
    $ wget -qO - https://adoptopenjdk.jfrog.io/adoptopenjdk/api/gpg/key/public | sudo apt-key add -
    ```

مخزن apt مربوط به AdoptOpenJDK را پیکربندی کنید.

    ```
    $ echo "deb https://adoptopenjdk.jfrog.io/adoptopenjdk/deb $(cat /etc/os-release | grep UBUNTU_CODENAME | cut -d = -f 2) main" | sudo tee /etc/apt/sources.list.d/adoptopenjdk.list
    ```

فهرست بسته را به روزرسانی کنید.

    ```
    $ sudo apt-get update
    ```

AdoptOpenJDK را نصب کنید.

    ```
    $ sudo apt-get install adoptopenjdk-11-hotspot -y
    $ sudo apt-get install jq -y
    ```

## ۲. ایجاد یک فایل مبادله (Swapfile)

یک فایل swap ایجاد کنید. این مثال یک فایل ۱ گیگابایتی اختصاص می دهد، این مقدار را
با توجه به نیاز خود تنظیم کنید.

    ```
    $ sudo fallocate -l 1G /swapfile
    ```

مجوزهای فایل swap را تنظیم کنید.

    ```
    $ sudo chmod 600 /swapfile
    ```

فضای swap را اختصاص دهید.

    ```
    $ sudo mkswap /swapfile
    ```

سواپ را روشن کنید.

    ```
    $ sudo swapon /swapfile
    ```

با تغییر `fstab`فایل، فایل swap خود را دائمی کنید.

    ```
    $ sudo nano /etc/fstab
    ```

این خط را به انتهای فایل اضافه کنید.

    ```
    /swapfile none swap sw 0 0
    ```

## ۳. نصب 󠀁[Paper](https://negarnovin.com/encyclopedia/paper/)󠁿 روی اوبونتو ۲۰.۰۴

`home`مطمئن شوید که در دایرکتوری کاربری هستید که قصد دارید برای [Paper](https://negarnovin.com/encyclopedia/paper/)
از آن استفاده کنید.

    ```
    $ cd ~
    ```

یک پوشه برای [Paper](https://negarnovin.com/encyclopedia/paper/) ایجاد کنید و آخرین
نسخه را دانلود کنید. این مثال نسخه [Paper](https://negarnovin.com/encyclopedia/paper/)
۱.۱۶.۵ را دانلود می کند. اگر به نسخه دیگری نیاز دارید، آن را `1.16.5`با نسخه ای 
که می خواهید دانلود کنید جایگزین کنید.

    ```
    $ mkdir paper
    $ cd paper
    $ LATEST_BUILD=$(curl -X GET "https://papermc.io/api/v2/projects/paper/versions/1.16.5" -H "accept: application/json" | jq '.builds[-1]')
    $ curl -o paperclip.jar -X GET "https://papermc.io/api/v2/projects/paper/versions/1.16.5/builds/${LATEST_BUILD}/downloads/paper-1.16.5-${LATEST_BUILD}.jar" -H "accept: application/java-archive" -JO
    ```

### اختیاری – نسخه قدیمی تر را نصب کنید

> اگر نسخه قدیمی تر را می خواهید، شماره ساخت های موجود را جستجو کنید.

    ```
    $ curl -X GET "https://papermc.io/api/v2/projects/paper/versions/1.16.5" -H "accept: application/json"
    ```

> در دستور زیر [BUILD_ID] را با نسخه مورد نظر جایگزین کنید.

    ```
    $ curl -o paperclip.jar -X GET "https://papermc.io/api/v2/projects/paper/versions/1.16.5/builds/[BUILD_ID]/downloads/paper-1.16.5-[BUILD_ID].jar" -H "accept: application/java-archive" -JO
    ```

## ۴. سرور را راه اندازی کنید

یک اسکریپت راه اندازی برای سرور خود ایجاد کنید.

    ```
    $ nano start.sh
    ```

موارد زیر را در `start.sh`. `4G`پارامترهای موجود در `-Xms4G -Xmx4G`پیکربندی جاوا
برای ۴ گیگابایت رم قرار دهید. این را به مقدار رمی که می خواهید برای [Paper](https://negarnovin.com/encyclopedia/paper/)
اختصاص دهید تغییر دهید. سیستم عامل به رم موجود نیز نیاز دارد، لطفاً تمام رم موجود
را به [Paper](https://negarnovin.com/encyclopedia/paper/) اختصاص ندهید. به عنوان
مثال، اگر VPS دارای ۸ گیگابایت رم است، می توانید تنظیم `-Xms7G -Xmx7G`. را در نظر
بگیرید.

    ```
    #!/bin/sh
    while true
    do
    java -Xms4G -Xmx4G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:+AlwaysPreTouch -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -XX:G1ReservePercent=20 -XX:G1HeapWastePercent=5 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1RSetUpdatingPauseTimePercent=5 -XX:SurvivorRatio=32 -XX:+PerfDisableSharedMem -XX:MaxTenuringThreshold=1 -Dusing.aikars.flags=https://mcflags.emc.gs -Daikars.new.flags=true -jar paperclip.jar nogui
    echo "restarting in 10"
    sleep 10
    done
    ```

قابل اجرا تبدیل کنید `start.sh`.

    ```
    $ chmod +x start.sh
    ```

سرور خود را راه اندازی کنید.

    ```
    $ ./start.sh
    ```

جاوا [Paper](https://negarnovin.com/encyclopedia/paper/) را دانلود می کند. اولین
باری که بارگذاری می شود، از شما می خواهد که EULA را بپذیرید و بارگذاری انجام نمی
شود. سپس اسکریپت حلقه می شود و در این مرحله برای خروج از اسکریپت باید Ctrl+ را تایپ
کنید.C

ویرایش کنید `eula.txt`.

    ```
    $ nano eula.txt
    ```

`eula=`از false به تغییر دهید `true`. فایل را ذخیره کرده و از آن خارج شوید.

سرور خود را دوباره راه اندازی کنید.

    ```
    $ ./start.sh
    ```

### اختیاری: اجرای سرور در پس زمینه

نصب صفحه نمایش.

    ```
    $ sudo apt-get install screen -y
    ```

یک نمونه از صفحه نمایش را باز کنید.

    ```
    $ screen -S "paper"
    ```

اسکریپت سرور خود را شروع کنید.

    ```
    $ cd ~/paper
    $ ./start.sh
    ```

تنظیمات سرور خود را پیکربندی کنید و افزونه ها را نصب کنید.

## عیب یابی

اگر paperclip.jar اجرا نشد، به رم بیشتری روی سرور خود یا یک فایل swap بزرگتر نیاز
دارید.
