Java Swing 实现 2D 像素风地形生成与动态世界导航教程

星浩同学_8762

星浩同学_8762

2026-11-16

784人浏览

原创

Java Swing 实现 2D 像素风地形生成与动态世界导航教程

本文介绍如何基于 swing 构建可扩展的 2d 地形系统,通过面向对象建模(biome/chunk/world)解耦逻辑与 ui,并利用键控导航实现类似 minecraft 的区块切换效果,避免阻塞主线程或轮询检测。

本文介绍如何基于 swing 构建可扩展的 2d 地形系统,通过面向对象建模(biome/chunk/world)解耦逻辑与 ui,并利用键控导航实现类似 minecraft 的区块切换效果,避免阻塞主线程或轮询检测。

在 Java Swing 中实现“类 Minecraft”式的 2D 地形系统,关键不在于暴力轮询组件坐标(如 while(true) 检查 JLabel 位置),而在于以数据驱动 UI、用事件替代轮询、靠抽象隔离变化。下面将从模型设计、UI 构建到完整运行逻辑,逐步呈现一个专业、可维护的实现方案。

✅ 核心设计原则:MVC 分离与接口抽象

首先定义清晰的数据契约,而非直接操作 JPanel:

public enum Biome { FOREST, PLAINS }

public interface Chunk {
    Biome getBiome();
    Point getLocation(); // 世界坐标 (x, y)
}

public interface World {
    Chunk getChunkAt(int x, int y);
}

public interface ChunkFactory {
    Chunk createChunk(Point worldLocation);
}

使用 interface 而非具体类,是为了支持未来扩展(例如添加 DESERT 生物群系、NOISE_BASED_GENERATION 工厂),并便于单元测试和依赖注入。

? 动态世界存储:基于 Map 的稀疏矩阵

传统二维数组(Chunk[][])要求预分配固定大小,而真实世界是无限且稀疏的。我们采用 HashMapMatrix 实现按需加载的稀疏矩阵:

public interface Matrix<t> {
    T get(int x, int y);
    void put(T value, int x, int y);
}

public class HashMapMatrix<t> implements Matrix<t> {
    private final Map<integer map t>> values = new HashMap();

    @Override
    public T get(int x, int y) {
        Map<integer t> row = values.get(y);
        return row == null ? null : row.get(x);
    }

    @Override
    public void put(T value, int x, int y) {
        values.computeIfAbsent(y, k -> new HashMap()).put(x, value);
    }
}</integer></integer></t></t></t>

该结构仅在访问 (x,y) 时才生成对应 Chunk,内存占用随玩家探索范围线性增长,天然支持“无限世界”。

? 世界生成器:可插拔的工厂模式

DefaultChunkFactory 随机分配生物群系,但逻辑完全独立于 UI:

Build Java agent transport gateways with Atmosphere
Build Java agent transport gateways with Atmosphere

使用Atmosphere构建通过WebSocket、SSE、gRPC、WebTransport、MCP、A2A和AG-UI流传输的JVM代理网关,并带有治理钩子。

下载
public class DefaultChunkFactory implements ChunkFactory {
    private final List<biome> biomes = Arrays.asList(Biome.values());

    @Override
    public Chunk createChunk(Point location) {
        Biome biome = biomes.get((int)(Math.random() * biomes.size()));
        return new DefaultChunk(biome, location);
    }
}

public class DefaultChunk implements Chunk {
    private final Biome biome;
    private final Point location;

    public DefaultChunk(Biome biome, Point location) {
        this.biome = biome;
        this.location = new Point(location);
    }

    @Override
    public Biome getBiome() { return biome; }
    @Override
    public Point getLocation() { return location; }
}</biome>

? 注意:此处 Math.random() 替代了原问题中易出错的 Random.nextInt(2)+1(越界风险),且避免硬编码颜色值——颜色应在视图层决定。

?️ 视图层:ChunkPane 与动态世界面板

ChunkPane 是 JPanel 的子类,仅负责渲染单个区块:

public class ChunkPane extends JPanel {
    public ChunkPane(Chunk chunk) {
        this.chunk = chunk;
        setBackground(chunk.getBiome() == Biome.FOREST ? Color.GREEN : Color.YELLOW);
        setLayout(new BorderLayout());
        add(new JLabel("[" + chunk.getLocation().x + "," + chunk.getLocation().y + "]"), BorderLayout.SOUTH);
    }

    @Override
    public Dimension getPreferredSize() {
        return new Dimension(200, 200);
    }
}

核心控制器 SwingCraft 管理玩家位置与区块切换,完全摒弃轮询,改用 Swing 标准事件机制:

public class SwingCraft extends JPanel {
    private final Matrix<chunkpane> cache = new HashMapMatrix();
    private final World world;
    private Point playerPos = new Point(0, 0);

    public SwingCraft(World world) {
        this.world = world;
        setLayout(new BorderLayout());
        setChunk(playerPos);

        // 键绑定:LEFT/RIGHT/UP/DOWN → 移动动作
        InputMap inputMap = getInputMap(WHEN_IN_FOCUSED_WINDOW);
        ActionMap actionMap = getActionMap();

        inputMap.put(KeyStroke.getKeyStroke(KeyEvent.VK_LEFT, 0), "left");
        inputMap.put(KeyStroke.getKeyStroke(KeyEvent.VK_RIGHT, 0), "right");
        inputMap.put(KeyStroke.getKeyStroke(KeyEvent.VK_UP, 0), "up");
        inputMap.put(KeyStroke.getKeyStroke(KeyEvent.VK_DOWN, 0), "down");

        actionMap.put("left", new MoveAction(-1, 0));
        actionMap.put("right", new MoveAction(1, 0));
        actionMap.put("up", new MoveAction(0, -1));
        actionMap.put("down", new MoveAction(0, 1));
    }

    private void setChunk(Point pos) {
        ChunkPane pane = cache.get(pos.x, pos.y);
        if (pane == null) {
            Chunk chunk = world.getChunkAt(pos.x, pos.y);
            pane = new ChunkPane(chunk);
            cache.put(pane, pos.x, pos.y);
        }
        removeAll();
        add(pane);
        revalidate();
        repaint();
    }

    private class MoveAction extends AbstractAction {
        private final int dx, dy;

        MoveAction(int dx, int dy) {
            this.dx = dx;
            this.dy = dy;
        }

        @Override
        public void actionPerformed(ActionEvent e) {
            playerPos.x += dx;
            playerPos.y += dy;
            setChunk(playerPos);
        }
    }
}</chunkpane>

✅ 运行与最佳实践要点

  • 无需多线程轮询:Swing 是单线程 GUI 框架,while(true) 会冻结界面;键事件天然异步且高效。
  • 中心化状态管理:玩家位置 playerPos 是唯一可信源,UI 刷新由 setChunk() 统一触发。
  • 避免 getContentPane() 比较:原问题中用 frame.getContentPane() == world[i][j] 判断当前面板,极易因引用失效导致 bug;本方案通过 playerPos 直接计算目标区块,逻辑更健壮。
  • 启动方式(确保在 Event Dispatch Thread 中):
    EventQueue.invokeLater(() -> {
        JFrame frame = new JFrame("SwingCraft");
        frame.add(new SwingCraft(new DefaultWorld(new DefaultChunkFactory())));
        frame.setDefaultCloseOperation(JFrame.EXIT_ON_CLOSE);
        frame.pack();
        frame.setLocationRelativeTo(null);
        frame.setVisible(true);
    });

这套架构不仅解决了原始需求(3×3 网格、中心房屋、边界响应),更构建了可无限扩展的地形引擎骨架——添加新生物群系只需新增 Biome 枚举值和 ChunkPane 渲染逻辑,无需修改世界生成或导航代码。这才是 Swing 场景下真正可持续的工程实践。

Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南

相关文章

一键重装系统工具
一键重装系统工具

一键重装系统工具是一款专注装机小白用的一键电脑重装系统软件。支持一键重装win7、win10、win11电脑系统。在线装机,无需光驱U盘,无需电脑技术,有需要的小伙伴快来保存下载体验吧!

下载

相关标签:

java

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
java
java

Java是一个通用术语,用于表示Java软件及其组件,包括“Java运行时环境 (JRE)”、“Java虚拟机 (JVM)”以及“插件”。php中文网还为大家带了Java相关下载资源、相关课程以及相关文章等内容,供大家免费下载使用。

2023.06.15

12737

6

java正则表达式语法
java正则表达式语法

java正则表达式语法是一种模式匹配工具,它非常有用,可以在处理文本和字符串时快速地查找、替换、验证和提取特定的模式和数据。本专题提供java正则表达式语法的相关文章、下载和专题,供大家免费下载体验。

2023.07.05

9822

9

java自学难吗
java自学难吗

Java自学并不难。Java语言相对于其他一些编程语言而言,有着较为简洁和易读的语法,本专题为大家提供java自学难吗相关的文章,大家可以免费体验。

2023.07.31

8332

8

java配置jdk环境变量
java配置jdk环境变量

Java是一种广泛使用的高级编程语言,用于开发各种类型的应用程序。为了能够在计算机上正确运行和编译Java代码,需要正确配置Java Development Kit(JDK)环境变量。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.01

1344

3

java保留两位小数
java保留两位小数

Java是一种广泛应用于编程领域的高级编程语言。在Java中,保留两位小数是指在进行数值计算或输出时,限制小数部分只有两位有效数字,并将多余的位数进行四舍五入或截取。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

2023.08.02

1068

3

java基本数据类型
java基本数据类型

java基本数据类型有:1、byte;2、short;3、int;4、long;5、float;6、double;7、char;8、boolean。本专题为大家提供java基本数据类型的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

1596

5

java有什么用
java有什么用

java可以开发应用程序、移动应用、Web应用、企业级应用、嵌入式系统等方面。本专题为大家提供java有什么用的相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.02

3329

5

java在线网站
java在线网站

Java在线网站是指提供Java编程学习、实践和交流平台的网络服务。近年来,随着Java语言在软件开发领域的广泛应用,越来越多的人对Java编程感兴趣,并希望能够通过在线网站来学习和提高自己的Java编程技能。php中文网给大家带来了相关的视频、教程以及文章,欢迎大家前来学习阅读和下载。

2023.08.03

20571

3

配置java环境变量
配置java环境变量

配置Java环境变量是为了让操作系统能够识别和使用Java的相关命令和功能。本专题为大家提供配置java环境变量相关文章,帮助大家解决问题。

2023.08.03

1435

8

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
dev.java 官方:Learn Java
dev.java 官方:Learn Java

共0课时 | 0人学习

Java JDBC数据库连接官方教程
Java JDBC数据库连接官方教程

共0课时 | 0人学习