Java SE 实现多人在线 MUD 系统：零框架网络编程实战

简介本资源是吉林大学高分Java课程设计项目——MUD多人在线文字冒险游戏的完整源码实现面向计算机专业本科生及Java初学者解决课程设计选题难、系统架构不清晰、网络通信实践薄弱等痛点。项目采用纯Java开发含10个核心Java源文件与16个编译后Class文件辅以Eclipse项目配置文件.project、.classpath、.prefs及编码相关配置ucd、acd、cld总32个文件压缩包仅55KB轻量易部署。已有109人学习下载代码全程手写并附详细中文注释涵盖Socket多线程通信、玩家状态管理、命令解析器、房间场景切换等关键模块结构清晰、功能闭环可直接用于期末大作业或毕业设计。项目经严格调试启动服务端与客户端后即可运行交互界面简洁、逻辑完整兼具教学示范性与工程参考价值。1. 这不是文字冒险游戏的怀旧复刻而是一套能跑通、能调试、能交差的 Java 多人在线终端交互系统吉大高分课程设计 MUD 源码实测拆解你手头正卡在 Java 期末大作业选题上导师说“要有网络通信、多线程、状态管理最好带点交互逻辑”——但 Spring Boot 写个 CRUD 又太单薄Netty 又怕翻车别硬啃《Java 网络编程》第 12 章了。这份来自吉林大学真实课堂的 MUDMulti-User Dungeon模拟项目不是 demo不是 skeleton是实打实拿 98 分、被导师当范例展示的完整源码包。它用纯 Java SE 实现了客户端连接管理、房间状态同步、命令解析器、玩家移动与交互逻辑所有代码都在src/com/下.classpath和.project文件保留 Eclipse 工程结构连注释都按课程设计规范写了三层类功能、方法作用、关键参数说明。新手照着README.md虽未明写但结构里隐含配好 JDK 85 分钟内就能启动服务端telnet localhost 8080 连上去走两步、打个怪、看自己和别人在同一个地图里实时移动——这不是玄学是可验证的终端级多人在线状态同步。适合 Java 初学者练手网络多线程也适合毕设同学快速搭建可演示、可扩展的轻量级服务端骨架。2. 从工程结构到核心流程为什么这个 MUD 不用框架也能稳住多人并发2.1 工程目录即运行契约Eclipse 项目结构暴露的真实依赖关系打开压缩包你会看到典型的 Eclipse Java 项目布局. ├── .project # Eclipse 项目元数据声明项目名、构建器、natures ├── .classpath # 关键定义编译路径src 为源码根bin 为输出目录无外部 jar 依赖 ├── .settings/ │ └── org.eclipse.jdt.core.prefs # 编码格式UTF-8、JDK compliance level1.8 ├── src/ │ └── com/ # 主包名下含 Server、Client、Game、Entity 等子包 ├── bin/ # 编译输出目录class 文件存放处非源码 └── newfile.* # 无关临时文件可忽略提示.classpath中没有classpathentry kindlib行证明该项目零第三方依赖。所有网络通信用java.net.ServerSocketSocket线程调度用java.util.concurrent基础类状态管理靠HashMapString, Playersynchronized块——这是课程设计的硬性要求也是你能快速读懂、修改、调试的根本前提。2.2 核心三件套Server、Player、Room 的职责边界与协作链路整个系统围绕三个核心类展开它们构成最小可行 MUD 骨架Server.java主入口监听端口默认 8080为每个新连接创建Player实例并将其注册进全局PlayerManagerPlayer.java代表一个在线用户持有Socket引用、BufferedReader/PrintWriter流、当前所在Room引用、背包ListItem、生命值等状态Room.java地图单元含String name、String description、MapString, Room定义四向出口north/south/east/west、ListPlayer记录当前在线玩家。它们的协作流程如下简化版// Server.java 片段接受连接后启动 Player 线程 public void start() { try (ServerSocket serverSocket new ServerSocket(8080)) { System.out.println(MUD Server started on port 8080); while (!Thread.interrupted()) { Socket clientSocket serverSocket.accept(); Player player new Player(clientSocket); // 关键Player 封装 socket new Thread(player).start(); // 启动独立线程处理该玩家 } } catch (IOException e) { e.printStackTrace(); } }Player构造函数中完成流初始化并调用playerLoop()进入命令循环Room的enter(Player p)方法会将玩家加入players列表并广播xxx enters the roomPlayer的move(String direction)方法则检查当前Room的出口映射若存在目标Room则调用currentRoom.exit(this)targetRoom.enter(this)完成位置切换——所有状态变更都发生在内存对象间不涉及数据库或序列化这是课程设计对“简单模拟”的精准实现。2.3 命令解析器用 String.split( ) 实现的轻量级 REPL比 Scanner 更可控MUD 的交互本质是文本命令行。本项目没用 ANTLR 或 JCommander而是手写了一个极简但健壮的CommandParser// Player.java 中的 parseCommand 方法 private void parseCommand(String input) { if (input null || input.trim().isEmpty()) return; String[] parts input.trim().split(\\s, 2); // 最多切两段命令 参数 String cmd parts[0].toLowerCase(); String args parts.length 1 ? parts[1] : ; switch (cmd) { case look: showCurrentRoom(); break; case go: move(args); break; case say: broadcastSay(args); break; case who: listPlayersInRoom(); break; case quit: disconnect(); break; default: send(Unknown command. Try: look, go dir, say text, who, quit); break; } }参数说明split(\\s, 2)是关键——它确保go north和go north door都只取第一个词north作为方向避免参数解析越界toLowerCase()统一命令大小写降低用户输入门槛broadcastSay()会遍历当前Room.players对每个Player调用send()发送xxx says: xxx实现房间级广播。这种设计牺牲了复杂语法支持但换来的是100% 可控、无反射、无配置、零学习成本正适合课程设计场景。2.4 状态同步机制为什么“两人同时进同一房间”不会丢消息多人在线的核心难点是状态一致性。本项目采用“中心广播 局部锁”策略所有Room对象由RoomManager单例统一管理Player移动时必须先获取Room对象锁Room.enter(Player p)方法内先synchronized(this)再players.add(p)最后遍历players广播进入消息Player.send(String msg)是线程安全的PrintWriter包装了OutputStream且Player线程独占该流无需额外同步。验证方式很简单开两个 telnet 窗口A 进forestB 进cave然后 Ago east进cave—— B 窗口立刻显示A enters the caveA 窗口显示You enter the cave且who命令双方都能看到对方。没有 WebSocket没有 Redis没有消息队列仅靠 JVM 内存对象 synchronized 块就实现了强一致的房间状态可见性。这是课程设计最值得细读的底层逻辑。3. 启动、连接与基础交互三步跑通五步验证功能完整性3.1 环境准备JDK 8 是唯一硬性要求拒绝版本踩坑本项目明确适配 JDK 1.8.settings/org.eclipse.jdt.core.prefs中org.eclipse.jdt.core.compiler.compliance1.8。请务必确认$ java -version # 输出必须包含 1.8.0_ 字样如 # java version 1.8.0_361 Java(TM) SE Runtime Environment (build 1.8.0_361-b09)注意JDK 11 会因java.nio.channels.SocketChannel默认行为变更导致Socket关闭异常JDK 17 的SecurityManager移除会让部分权限检查报错。若已装高版本 JDK请用JAVA_HOME切换或直接下载 Adoptium Temurin 8u361 免费、稳定、课程设计标配。3.2 编译与启动脱离 IDE用 javac/jar 命令直击本质不要依赖 Eclipse 导入——手动编译才能真正理解依赖关系# 1. 进入项目根目录含 src/ bin/ .classpath 的目录 cd /path/to/mud-project # 2. 创建编译输出目录若 bin/ 为空或损坏 mkdir -p bin # 3. 编译所有 .java 文件到 bin/ javac -d bin -sourcepath src src/com/server/Server.java # 4. 运行服务端-cp 指定 classpath. 表示当前目录即 bin/ java -cp bin com.server.Server # 输出MUD Server started on port 8080逻辑说明-d bin指定 class 文件输出到bin/-sourcepath src告诉编译器源码在src/下src/com/server/Server.java是主类路径注意包名com.server对应src/com/server/目录结构-cp bin让 JVM 在bin/下找com/server/Server.class及其依赖的其他 class。这一步绕过 IDE直面 Java 类路径本质。3.3 客户端连接用 telnet 验证比写客户端更高效Windows 自带 telnet需启用macOS/Linux 用ncnetcat# Windows管理员运行 PowerShell 启用 Enable-WindowsOptionalFeature -Online -FeatureName TelnetClient # 连接服务端 telnet localhost 8080 # 或 macOS/Linux nc localhost 8080连接成功后你会看到欢迎语如Welcome to JLU MUD! Type look to begin.然后尝试 look You are in a dimly lit forest. Paths lead north and east. go north You enter a dark cave. A small stream flows south. say Hello everyone! A says: Hello everyone! who Players here: A参数说明telnet和nc都是原始 TCP 客户端它们不解析协议只负责收发字节流——这恰恰验证了本项目PrintWriter/BufferedReader的健壮性。如果go north后卡住大概率是Room的north出口未正确指向cave实例需检查RoomManager初始化逻辑。3.4 功能验证清单用 7 条命令覆盖全部核心能力命令预期效果验证要点故障现象look显示当前房间描述及出口描述文本是否匹配Room.description显示空字符串或nullgo dir移动到对应方向房间Player.currentRoom是否更新新房间players是否包含该玩家卡住不动或报You cant go that waysay text向当前房间所有人广播所有在线玩家窗口均显示xxx says: text仅自己看到或报NullPointerExceptionwho列出当前房间所有玩家输出格式为Players here: A, B显示空列表或抛ConcurrentModificationExceptionquit断开连接并清理资源Player线程终止Room.players移除该玩家连接不断开或服务端报SocketException: Broken pipehelp显示可用命令列表若实现检查CommandParser是否有helpcase输入help无响应仍走default多窗口并发两个 telnet 窗口同时操作Ago eastB 立即看到 A 进入Bsay hiA 立即收到消息延迟 1s或一方收不到4. 避坑指南98 分项目的血泪经验这些坑我替你踩过了4.1 现象telnet 连接后立即断开控制台报java.net.SocketException: Connection reset原因Player线程在run()方法中未捕获IOException当客户端异常关闭如 CtrlC时readLine()抛出异常线程终止但Player对象未从Room.players中移除导致后续broadcast时对已关闭 socket 调用write()。解决在Player.run()的while (isConnected)循环内readLine()外层加try-catch (IOException e)捕获后执行disconnect()清理逻辑// Player.java run() 方法片段 public void run() { try { while (isConnected) { String input reader.readLine(); // 可能抛 IOException parseCommand(input); } } catch (IOException e) { // 客户端异常断开主动清理 System.out.println(Player name disconnected unexpectedly); disconnect(); } }4.2 现象两人同时go north进同一房间who命令只显示一人原因Room.enter(Player p)方法未加synchronized导致两个Player线程并发调用players.add(p)引发ArrayList的ConcurrentModificationException或数据丢失。解决给Room.enter()加synchronized或改用线程安全集合// Room.java private final ListPlayer players Collections.synchronizedList(new ArrayList()); // 或更推荐在 enter 方法上加 synchronized public synchronized void enter(Player p) { players.add(p); broadcast(p.getName() enters the room.); }注意Collections.synchronizedList仅保证单个方法原子性broadcast遍历仍需同步块故直接synchronized method更稳妥。4.3 现象say命令发送中文乱码显示为??或方块原因PrintWriter默认使用平台编码Windows 是 GBKLinux/macOS 是 UTF-8而BufferedReader读取时未指定编码导致读写编码不一致。解决显式指定 UTF-8 编码创建流// Player.java 构造函数中 this.reader new BufferedReader( new InputStreamReader(socket.getInputStream(), StandardCharsets.UTF_8) ); this.writer new PrintWriter( new OutputStreamWriter(socket.getOutputStream(), StandardCharsets.UTF_8), true );提示true参数开启自动 flush避免消息滞留缓冲区。4.4 现象编译时报错package com.server does not exist即使目录结构正确原因javac命令未正确设置-sourcepath或源码文件未放在src/com/server/Server.java路径下常见错误把Server.java直接放src/下。解决严格遵循包声明路径。检查Server.java第一行是否为package com.server;然后确认文件物理路径为src/com/server/Server.java。编译命令必须用javac -d bin -sourcepath src src/com/server/Server.java不可省略src/前缀。4.5 现象服务端启动后telnet 连接成功但无任何输出输入命令无响应原因Server主线程未正确启动Player线程或Player.run()中while (isConnected)条件恒为 false。排查在Server.start()的new Thread(player).start();后加System.out.println(Player thread started for player.getName());在Player.run()开头加System.out.println(Player name thread running);。若无打印说明线程未启动若有打印但无后续检查isConnected初始化值应为true及reader.readLine()是否阻塞正常情况会阻塞等待输入。5. 进阶改造从课程设计到可演示毕设的四个关键升级点5.1 添加持久化用 Properties 文件保存房间与物品配置告别硬编码课程设计允许内存运行但毕设需体现数据管理能力。Room和Item的静态定义如森林、洞穴、宝剑可抽离为配置文件# config/rooms.properties forest.nameDark Forest forest.descA misty forest with ancient trees. Paths lead north and east. forest.northcave forest.eastriver cave.nameDeep Cave cave.descStalactites drip water. A narrow passage leads south. cave.southforest加载逻辑RoomManager.javapublic static void loadRooms() { Properties props new Properties(); try (InputStream is RoomManager.class.getClassLoader() .getResourceAsStream(config/rooms.properties)) { props.load(is); Enumeration? keys props.keys(); while (keys.hasMoreElements()) { String key (String) keys.nextElement(); if (key.endsWith(.name)) { String id key.substring(0, key.length() - 5); // 去掉 .name Room room new Room(); room.setId(id); room.setName(props.getProperty(id .name)); room.setDescription(props.getProperty(id .desc)); // 解析出口 String[] directions {north, south, east, west}; for (String dir : directions) { String targetId props.getProperty(id . dir); if (targetId ! null) room.setExit(dir, targetId); } rooms.put(id, room); } } } catch (IOException e) { e.printStackTrace(); } }价值点配置与代码分离新增房间只需改 properties 文件无需重编译getResourceAsStream确保打包成 jar 后仍可读取。5.2 增强交互实现物品拾取与使用用状态机管理玩家动作当前Player只有移动和说话。添加物品系统可提升演示效果// Item.java public class Item { private String name; private String description; private boolean isUsable; // 如钥匙可开门 } // Player.java 新增 private ListItem inventory new ArrayList(); public void take(String itemName) { /* 检查当前房间是否有该物品移入 inventory */ } public void use(String itemName) { /* 若 isUsable触发效果如打开密室 */ }关键在于use的状态机设计Player当前状态如IN_ROOM,FIGHTING,USING_ITEM决定可执行命令。例如只有IN_ROOM状态才允许takeUSING_ITEM状态下go应被拒绝。这比单纯增加方法更能体现面向对象设计深度。5.3 提升健壮性用 ExecutorService 替代裸 Thread统一管理连接生命周期原new Thread(player).start()缺乏线程池管理高并发下易 OOM。替换为// Server.java private final ExecutorService playerPool Executors.newCachedThreadPool(r - { Thread t new Thread(r, Player-Thread- counter.incrementAndGet()); t.setDaemon(true); // 防止 JVM 因线程未结束而挂起 return t; }); // accept 后 playerPool.submit(player);参数说明newCachedThreadPool动态创建线程空闲 60 秒自动回收setDaemon(true)确保主线程结束时所有玩家线程自动终止counter是AtomicInteger生成唯一线程名便于日志追踪。5.4 演示优化添加简易 Web 管理界面用 Jetty 嵌入式服务器暴露状态毕设答辩时纯 telnet 演示不够直观。嵌入 Jetty 暴露/status接口!-- pom.xml 添加 -- dependency groupIdorg.eclipse.jetty/groupId artifactIdjetty-server/artifactId version9.4.51.v20230217/version /dependency// StatusHandler.java public class StatusHandler extends AbstractHandler { Override public void handle(String target, Request baseRequest, HttpServletRequest request, HttpServletResponse response) throws IOException, ServletException { response.setContentType(text/html;charsetutf-8); PrintWriter out response.getWriter(); out.println(h2MUD Server Status/h2); out.println(pTotal players: PlayerManager.getOnlineCount() /p); out.println(pRooms: RoomManager.getRoomCount() /p); baseRequest.setHandled(true); } } // Server.java 启动后 Server jetty new Server(8081); jetty.setHandler(new StatusHandler()); jetty.start();访问http://localhost:8081/status即可看到实时在线人数与房间数无需 telnet评委一眼看懂系统负载。从那以后我每次做课程设计都强制走一遍javac -d bin -sourcepath src ...编译流程再手敲java -cp bin ...启动——不是为了炫技而是确保自己真的懂类路径、懂依赖、懂 JVM 是怎么找到那个main方法的。这份吉大 MUD 源码最珍贵的不是 98 分而是它用最朴素的 Java SE 元素把网络、线程、状态管理这些概念钉死在可触摸的代码里。希望帮到你。本文还有配套的精品资源点击获取