讲师中心 微信公众号

工具推荐

视频效率加速
Laper
Laper

剧本策划到成片协作

立刻MV
立刻MV

低成本歌曲 MV、视频生成

AniShort
AniShort

AI短剧协同制作平台

Seko
Seko

AI短剧一键生成成片

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

星浩同学_8762

星浩同学_8762

发布时间:2026-11-16 17:41:29

|

784人浏览过

|

来源于php中文网

原创

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 实现按需加载的稀疏矩阵:

立即学习“Java免费学习笔记(深入)”;

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<Integer, 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);
    }
}

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

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

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

下载

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

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

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; }
}

? 注意:此处 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);
        }
    }
}

✅ 运行与最佳实践要点

  • 无需多线程轮询: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 场景下真正可持续的工程实践。

相关文章

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

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

下载

相关标签:

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

热门AI工具

更多
Atoms
Atoms Hot

Atoms是一款AI智能体工具,第一支自动构建真实业务的 AI 团队。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

码上飞
码上飞 Hot

一款基于自然语言的AI应用开发平台,可根据用户描述自动生成应用程序,帮助个人和团队快速完成应用原型与开发。

二狗PPT
二狗PPT Hot

一款AI演示文稿工具,主要用于专为中式职场打造的AI PPT生成工具,适合需要提升相关任务效率的用户。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

墨刀AI
墨刀AI Hot

一款AI图像与设计工具,主要用于产品经理的专属智能体,适合需要提升相关任务效率的用户。

Loomy
Loomy Hot

一款AI工具,主要用于科大讯飞发布的桌面级 AI 助理,比 OpenClaw 更易用、更安全!,适合需要提升相关任务效率的用户。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

相关专题

更多
java
java

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

12737

2023.06.15

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

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

9822

2023.07.05

java自学难吗
java自学难吗

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

8332

2023.07.31

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

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

1344

2023.08.01

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

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

1068

2023.08.02

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

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

1596

2023.08.02

java有什么用
java有什么用

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

3329

2023.08.02

java在线网站
java在线网站

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

20571

2023.08.03

Go-Zero API开发使用教程
Go-Zero API开发使用教程

本专题聚焦Go-Zero的API开发,拆解.api描述文件的语法结构、路由与分组定义、参数绑定与校验规则,说明统一响应体、JWT鉴权、跨域与接口文档生成的落地方式,并给出网关聚合与接口测试的实践建议。

140

2026.11.12

热门下载

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

精品课程

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

共0课时 | 0人学习

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

共0课时 | 0人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn