==================================================
登录区的安装
==================================================
本节主要说明如何通过 Paper 安装包来搭建登录分区（大厅/主城），为玩家提供统一入口和分区选择。

前置工作
==================================================

- Paper 最新版本推荐使用 1.21.6 及以上，下载地址：`paper <https://papermc.io/downloads>`_
- 请确保已完成 :ref:`操作系统的选型和安装` 和 :ref:`选择安装java`，建议 Java 21
- 服务器目录结构、端口分配等请参考前文规划

安装步骤
==================================================

1. 下载并准备 Paper 核心
2. 创建分区目录（如 /home/mc/instances/dl1）
3. 移动并重命名 jar 包为分区名（如 dl1.jar）
4. 首次启动生成配置文件，接受 EULA
5. 修改 server.properties 端口、RCON、正版验证等关键配置
6. 再次启动，确保服务端正常运行

.. code-block:: bash

    # 创建主城（login）文件夹
    cd /home/mc/instances/
    mkdir dl1
    cd dl1/
    cp ~/paper-1.21.6.jar .
    mv paper-1.21.6-48.jar dl1.jar
    java -jar dl1.jar
    sed -i  's@eula=false@eula=true@g' eula.txt
    # 修改端口和关键配置
    sed -i 's@server-port=25565@server-port=10001@g' server.properties
    sed -i 's@query.port=25565@query.port=10001@g' server.properties
    sed -i 's@rcon.port=25575@rcon.port=11001@g' server.properties
    sed -i 's@enable-rcon=false@enable-rcon=true@g' server.properties
    sed -i 's@^rcon\.password=$@rcon.password=mc_panda_142857@g' server.properties
    sed -i 's@enforce-secure-profile=true@enforce-secure-profile=false@g' server.properties
    sed -i 's@online-mode=true@online-mode=false@g' server.properties
    sed -i 's@spawn-protection=16@spawn-protection=0@g' server.properties
    java -jar dl1.jar

.. note::
   端口需与前文规划一致，online-mode 必须为 false，RCON 密码请自行设置。

联机测试
==================================================
1. 使用启动器选择 1.21.6 版本，连接服务器 IP:10001
2. 能正常进入世界即为安装成功

.. image:: imgs/paper连接.jpg
    :width: 600px
    :align: center
    :alt: paper连接
    :name: paper连接

.. image:: imgs/paper登录成功.jpg
    :width: 600px
    :align: center
    :alt: paper登录成功
    :name: paper登录成功

.. note::  
   端口已修改，测试时请加端口号。

.. warning::  
   当前登录区未配置任何登录/注册插件，后续章节会补充相关内容。

整理启动脚本
==================================================
为便于后续多分区统一管理，建议使用启动脚本批量管理各分区服务端。

.. code-block:: bash

    # 建立软链接，便于 systemctl 或 service 管理
    sudo ln -s /home/mc/My_Study_MC/source/开服教程/codes/scripts/sysv/mc_control.sh /etc/init.d/mc_proxy
    sudo ln -s /home/mc/My_Study_MC/source/开服教程/codes/scripts/sysv/mc_control.sh /etc/init.d/mc_login
    sudo ln -s /home/mc/My_Study_MC/source/开服教程/codes/scripts/sysv/mc_control.sh /etc/init.d/mc_sc1
    sudo ln -s /home/mc/My_Study_MC/source/开服教程/codes/scripts/sysv/mc_control.sh /etc/init.d/mc_sc2
    sudo ln -s /home/mc/My_Study_MC/source/开服教程/codes/scripts/sysv/mc_control.sh /etc/init.d/mc_dp1

:download:`mc_control.sh <../codes/scripts/sysv/mc_control.sh>`

.. tip::
   启动脚本可实现 start/stop/restart/status 等操作，便于批量维护和自动化。

常见问题 QA
==================================================
:Q1:  启动后无法进入服务器？  
:A1:  检查端口是否正确、EULA 是否同意、online-mode 是否为 false，查看日志定位问题。

:Q2:  连接提示“服务器离线”或“无法验证用户名”？  
:A2:  请确认 online-mode=false，且未被防火墙/安全组拦截端口。

:Q3:  RCON 无法连接？  
:A3:  检查 enable-rcon=true、rcon.port、rcon.password 配置，确保端口已放行。

:Q4:  如何批量重启所有分区？  
:A4:  可用脚本或 systemctl/service 批量操作所有分区服务端。

:Q5:  登录区需要哪些插件？  
:A5:  推荐后续安装登录/注册、反作弊、欢迎信息等插件，详见后续章节。

优化建议与后续指引
==================================================
- 登录区建议仅用于分流和新手引导，尽量保持纯净，减少插件负担
- 后续可根据需求安装登录/注册、欢迎、公告、反作弊等插件
- 统一使用启动脚本和 systemd 管理所有分区，提升运维效率
- 详细插件推荐和配置请参考后续“登录区插件与安全加固”章节

.. note::
   登录区是玩家的第一印象，建议保持简洁、稳定，后续可逐步完