alloverse/alloplace

Alloverse Placeserv

镜像概述和主要用途

Alloverse Placeserv是Alloverse的服务器组件，本质上是一个多人游戏服务器，专门用于窗口管理器相关的功能。它是Alloverse生态系统的核心服务组件，负责处理多人连接和窗口管理相关的服务。

核心功能和特性

• 作为Alloverse的服务器组件，提供基础的多人连接支持
• 专注于窗口管理器相关功能的服务处理
• 支持通过Docker容器化部署，简化环境配置
• 可扩展支持添加捆绑应用

使用场景和适用范围

适用于Alloverse生态系统的服务器端部署，尤其适合需要多人协作的窗口管理器相关应用场景，可作为基础服务支持各类基于Alloverse的窗口管理应用。

详细使用方法和配置说明

安装设置

通用前置步骤

bash
git submodule update --init --recursive

macOS系统

1. 安装asdf版本管理器（支持多种语言）：

   bash
   brew install asdf
   

   更多设置说明参见：[***]
2. 添加Erlang和Elixir插件：

   bash
   asdf plugin add erlang && asdf plugin add elixir
   

3. 安装指定版本的Erlang和Elixir：

   bash
   asdf install erlang 22.3 && asdf install elixir 1.9
   

4. 设置Erlang头文件路径：

   bash
   export CPATH=~/.asdf/installs/erlang/22.3//usr/include
   

5. 获取依赖：

   bash
   mix deps.get
   

Ubuntu系统（包括Windows上的Ubuntu子系统）

1. 下载Erlang解决方案包：

   bash
   wget https://packages.erlang-solutions.com/erlang-solutions_1.0_all.deb
   

2. 安装并清理安装包：

   bash
   sudo dpkg -i erlang-solutions_1.0_all.deb; rm erlang-solutions_1.0_all.deb
   

3. 更新软件源：

   bash
   sudo apt-get update
   

4. 安装必要依赖：

   bash
   sudo apt-get install esl-erlang
   sudo apt-get install elixir cmake clang openssl
   

5. 获取依赖：

   bash
   mix deps.get
   

运行方法

直接运行

bash
mix run --no-halt

Docker部署

1. 构建镜像：

   bash
   docker build -t alloplace .
   

2. 运行容器（设置名称并映射端口）：

   bash
   ALLOPLACE_NAME="lol" docker run -p 21337:21337/udp -it alloplace
   

添加捆绑应用

1. 添加子模块：

   bash
   git submodule add <仓库URL> alloapp/<名称>
   

2. 在placeentity.ex文件的206行添加到白名单：

   erlang
   or appname = "<名称>"
   

3. 在Dockerfile中添加辅助获取命令：

   dockerfile
   RUN cd alloapps/<名称>; ./allo/assist fetch