Skip to content

ELFTS/MPhone

Repository files navigation

MPhone Mod - 我的世界手机模组

这是一个为Minecraft 1.12.2开发的手机模组。

功能特点

  • 添加手机物品到游戏中
  • 右键点击手机可以打开GUI界面
  • 16:9全面屏手机设计 - 更现代的宽屏比例
  • 状态栏 - 顶部显示信号强度、运营商、游戏时间、电量百分比
  • 三大金刚键 - 底部导航栏包含返回、主页、多任务键
  • 手机界面包含应用按钮: 联系人、短信、相机、设置、应用、商店
  • 真实游戏时间显示 - 状态栏显示Minecraft世界时间
  • 信号强度显示 - 状态栏显示基站信号强度和SIM卡状态
  • 电池系统 - 手机需要电量才能使用,状态栏显示电量百分比
  • 充电台 - 放置充电台为手机充电
  • 相机拍照功能 - 点击相机按钮拍摄照片并保存
  • 相册系统 - 查看拍摄的照片,支持缩放和删除
  • 短信系统 - 发送和接收短信,支持多行消息气泡
  • 联系人功能 - 每个手机独立的联系人列表,支持添加、编辑、删除联系人,彩色头像显示,详情页可直接发短信
  • 应用商店 - 免费安装/卸载各种应用
  • 手机设置 - 声音、通知、壁纸等设置
  • 电话卡系统 - 6位电话号码,插入SIM卡才能使用通信功能
  • 基站系统 - 放置基站提供信号覆盖,无信号时无法发送短信
  • 应用状态记忆 - 关闭GUI后重新打开会回到上次使用的应用
  • 数据持久化 - 短信数据保存到世界存档,退出游戏不丢失
  • 村民交易 - 手机商人村民,可交易手机、SIM卡、充电台、信号基站
  • 刷怪蛋 - 手机商人刷怪蛋,方便生成村民
  • 支持中英文本地化
  • 创造模式工具栏可找到手机物品

环境要求

  • Java 8 (JDK 1.8)
  • Minecraft 1.12.2
  • Forge 1.12.2-14.23.5.2859+

开发环境设置

  1. 确保已安装Java 8
  2. 在项目目录下运行:
    # 生成IDE运行配置
    gradlew genIntellijRuns  # 如果使用IntelliJ IDEA
    #
    gradlew genEclipseRuns   # 如果使用Eclipse

构建模组

# 构建模组文件
gradlew build

构建完成后,模组文件将位于 build/libs/MPhone-1.12.2-1.1.0.jar

安装模组

  1. 确保已安装Forge 1.12.2
  2. MPhone-1.12.2-1.1.0.jar 复制到 .minecraft/mods/ 文件夹
  3. 启动Minecraft,选择Forge版本
  4. 在创造模式工具栏中找到"MPhone手机"、"电话卡"、"信号基站"、"充电台"和"手机商人刷怪蛋"

运行测试

# 运行客户端测试
gradlew runClient

# 运行服务端测试
gradlew runServer

常用Gradle命令

命令 说明
gradlew build 构建模组
gradlew runClient 运行客户端
gradlew runServer 运行服务端
gradlew clean 清理构建文件
gradlew tasks 查看所有可用任务

使用说明

信号基站

功能介绍:

  • 提供64格半径的信号覆盖范围
  • 手机需要在基站范围内才能显示信号
  • 信号强度根据距离衰减:4格(0-16格) → 3格(16-32格) → 2格(32-48格) → 1格(48-64格)

使用方法:

  1. 在创造模式工具栏中找到"信号基站"
  2. 放置在世界中任意位置
  3. 基站会发光,作为装饰和功能性方块

充电台

功能介绍:

  • 为手机提供充电功能
  • 每次右键充电增加20%电量
  • 充电时会播放音效
  • 手机充满电后会提示

使用方法:

  1. 在创造模式工具栏中找到"充电台"
  2. 放置在世界中任意位置
  3. 手持手机,右键点击充电台即可充电
  4. 物品栏悬停手机可查看当前电量

电量消耗说明:

  • 打开手机GUI:消耗2%电量
  • 发送短信:消耗3%电量
  • 拍照:消耗5%电量
  • 待机:每分钟消耗1%电量

联系人

功能介绍:

  • 每个手机拥有独立的联系人列表(基于SIM卡号码隔离)
  • 添加、查看、编辑和删除联系人
  • 联系人显示彩色头像(名字首字)
  • 联系人详情页可直接发送短信
  • 联系人数据保存到世界存档
  • 在短信系统中自动显示联系人名称

使用方法:

  1. 打开手机GUI,点击"联系人"按钮
  2. 联系人列表界面:
    • 查看当前手机已保存的联系人
    • 点击"新建"按钮添加联系人
    • 点击"查看"按钮查看联系人详情
  3. 联系人详情界面:
    • 显示联系人头像、姓名和电话
    • 点击"发短信"直接给该联系人发送短信
    • 点击"编辑"修改联系人信息
    • 点击"删除"删除联系人
  4. 新建/编辑联系人:
    • 输入联系人姓名(最多20字)
    • 输入6位电话号码
    • 点击"保存"

注意: 每个SIM卡(每个手机)的联系人列表是独立的,更换SIM卡后会显示该SIM卡对应的联系人列表

短信系统

功能介绍:

  • 发送和接收短信消息
  • 支持多行消息气泡显示(自动换行)
  • 会话列表显示所有联系人
  • 未读消息标记(红色圆点)
  • 需要信号基站才能发送短信
  • 短信数据保存到世界存档,退出游戏不丢失

使用方法:

  1. 确保已插入SIM卡且在信号基站范围内
  2. 打开手机GUI,点击"短信"按钮
  3. 会话列表界面:
    • 查看所有短信会话
    • 点击"新建"按钮发送新短信
    • 点击会话查看聊天记录
  4. 聊天界面:
    • 绿色气泡 = 你发送的消息
    • 灰色气泡 = 收到的消息
    • 输入消息后点击"发送"或按回车
  5. 新建短信:
    • 输入6位收件人号码
    • 输入短信内容(最多100字)
    • 点击"发送"

相册系统

功能介绍:

  • 查看游戏中拍摄的照片
  • 支持真实图片显示(保持原始比例)
  • 支持放大缩小(鼠标滚轮)
  • 支持删除照片
  • 照片列表网格显示
  • 单张照片查看模式

使用方法:

  1. 打开手机GUI,点击"相册"按钮
  2. 照片列表界面:
    • 查看所有拍摄的照片缩略图
    • 点击照片进入查看模式
    • 点击左右箭头翻页
  3. 照片查看界面:
    • 查看完整照片
    • 鼠标滚轮向上滚动放大
    • 鼠标滚轮向下滚动缩小
    • 点击"删除"删除当前照片
    • 点击"重置"恢复原始大小
    • 点击"上一张"/"下一张"切换照片

照片存储路径:

  • 照片保存在 .minecraft/screenshots/mphone/ 目录
  • 支持 PNG 和 JPG 格式

电话卡

功能介绍:

  • 每张电话卡有唯一的6位电话号码
  • 必须插入手机才能使用通信功能
  • 可在物品栏中查看电话号码

使用方法:

  1. 在创造模式工具栏中找到"电话卡"
  2. 手持电话卡,右键点击手机即可插入
  3. 潜行+右键手机可取出电话卡

手机商人村民

功能介绍:

  • 特殊的村民职业,专门交易手机相关物品
  • 5个交易等级:新手、学徒、老手、专家、大师
  • 随着交易等级提升,解锁更多交易选项

交易列表:

等级 交易内容
新手 8-12绿宝石 → 手机;2-4绿宝石 → SIM卡
学徒 5-8绿宝石+2铁锭 → 手机;10-19红石 → SIM卡
老手 20-29绿宝石 → 2个手机;3-5金锭 → 2个SIM卡;15-24绿宝石+2铁块 → 充电台
专家 2-3钻石 → 手机;手机 → 3-5绿宝石(回收);3-5钻石+5红石块 → 信号基站
大师 32-47绿宝石 → 3个手机;5金锭+10绿宝石 → 2个手机

生成方式:

  1. 刷怪蛋 - 在创造模式工具栏中找到"手机商人刷怪蛋"
  2. 命令 - 使用 /spawnphoneseller [x] [y] [z] 命令生成

如何使用手机

  1. 在创造模式工具栏中找到"MPhone手机"
  2. 将手机拿在手中,右键点击打开GUI界面
  3. 状态栏显示:
    • 左侧:信号强度(4格竖条显示)+ 运营商名称
    • 中间:游戏时间
    • 右侧:电量百分比 + 电池图标
  4. 在GUI界面中可以看到应用图标(4行4列布局,每页最多16个):
    • 系统应用(固定显示)
      • 联系人 - 查看和管理联系人
      • 短信 - 发送和接收短信
      • 相机 - 拍照功能
      • 相册 - 查看拍摄的照片
      • 设置 - 手机设置(声音、通知、壁纸)
      • 商店 - 应用商店
    • 已安装应用 - 从应用商店安装的应用会显示在这里
  5. 翻页浏览 - 如果应用超过16个,点击左右箭头翻页
  6. 应用状态记忆 - 关闭GUI后重新打开会自动回到上次使用的应用界面
  7. 电量管理 - 手机需要电量才能使用,电量耗尽时无法打开手机
    • 物品栏悬停手机可查看当前电量
    • 使用充电台为手机充电

手机设置

功能介绍:

  • 声音 - 开启/关闭手机声音
  • 通知 - 开启/关闭通知
  • 壁纸 - 更换手机壁纸(默认/蓝色/绿色/紫色/暗色)
  • 关于手机 - 显示版本信息

使用方法:

  1. 打开手机GUI,点击"设置"按钮
  2. 点击对应选项进行设置
  3. 点击左上角"←"返回主界面

应用商店

功能介绍:

  • 浏览和安装各种应用
  • 按分类筛选: 全部、工具、游戏、社交、生产力、娱乐
  • 免费安装和卸载应用
  • 支持上下滚动浏览所有应用

内置应用列表:

应用名称 分类 说明
指南针 工具 显示方向的实用工具
时钟 工具 显示当前游戏时间
计算器 工具 进行基本数学计算
贪吃蛇 游戏 经典贪吃蛇游戏
俄罗斯方块 游戏 经典方块消除游戏
聊天室 社交 与服务器玩家聊天
邮件 社交 发送和接收邮件
备忘录 生产力 记录重要事项
音乐播放器 娱乐 播放游戏音乐
我的房子 娱乐 进入私人房子维度

使用方法:

  1. 打开手机GUI,点击"商店"按钮
  2. 在应用商店界面浏览应用列表
  3. 点击顶部分类按钮筛选应用类型
  4. 点击应用右侧的"安装"按钮安装应用
  5. 已安装的应用会显示"卸载"按钮,点击可卸载

相机功能

使用方法:

  1. 打开手机GUI
  2. 点击"相机"按钮
  3. 等待3秒倒计时 (3... 2... 1...)
  4. 照片自动保存到 screenshots/mphone/ 目录
  5. 照片带有水印: "MPhone Camera" + 拍摄时间

照片特点:

  • 格式: PNG
  • 分辨率: 游戏窗口分辨率
  • 保存路径: .minecraft/screenshots/mphone/
  • 文件名: MPhone_Photo_yyyy-MM-dd_HH-mm-ss.png
  • 自动添加水印

GUI界面特点

  • 全面屏设计 - 绿色外壳
  • 16:9宽屏比例 - 180x320像素,更现代的显示效果
  • 16个应用按钮 - 4行4列布局,方形设计,彩色图标,支持翻页
  • 状态栏 - 顶部显示,包含信号强度、运营商、时间、电量百分比
  • 三大金刚键 - 底部导航栏:返回键◁、主页键○、多任务键□
  • 优化的应用布局 - 所有应用界面布局合理美观,操作便捷
  • 视觉效果 - 按钮悬停高亮、立体阴影、文字阴影效果

三大金刚键

功能介绍:

  • 返回键◁ - 返回手机主界面
  • 主页键○ - 返回手机主界面
  • 多任务键□ - 显示多任务提示(开发中)

使用方法:

  • 在任何应用界面底部都可以点击三大金刚键
  • 返回键和主页键都会返回到手机主界面
  • 方便快速切换应用或退出当前应用

应用界面布局

联系人应用:

  • 联系人列表:24x24像素头像,名称和号码分两行显示
  • 联系人详情:80x80像素大头像居中,信息清晰排列
  • 编辑界面:输入框标签左对齐,输入区域右对齐

短信应用:

  • 会话列表:28x28像素头像,名称、预览内容、时间布局紧凑
  • 聊天界面:消息气泡自适应宽度,输入框固定在底部
  • 未读消息显示红点标记

相册应用:

  • 照片列表:2x3网格布局,64x48像素缩略图
  • 照片查看:全屏显示,支持缩放
  • 操作按钮:删除、上一张、下一张、重置缩放

设置应用:

  • 设置项列表:图标+名称+状态,每项高度一致
  • 壁纸预览显示在右上角
  • 关于信息底部居中显示

应用商店:

  • 分类筛选按钮水平排列
  • 应用列表:32x32像素图标,名称、类型、状态垂直排列
  • 滚动指示器清晰显示页码

我的房子应用

功能介绍:

  • 进入你的私人房子维度
  • 大空岛设计,包含一个宽敞的房子
  • 房子内有床、箱子、工作台、熔炉等设施
  • 床可以正常使用,不会爆炸
  • 可以安全地设置重生点
  • 返回主世界时会回到传送前的位置

房子维度特点:

  • 大型圆形空岛底座(半径40格)
  • 15x13大小的宽敞房子
  • 有门、多个窗户、金字塔形屋顶
  • 内部装饰:床、箱子、工作台、熔炉、书架、火把照明
  • 岛周围有树木和花草装饰
  • 门前有小径延伸到岛边缘
  • 永久白天,不会下雨,不会刷怪
  • 掉入虚空会自动传送回安全位置
  • 取消摔落伤害

使用方法:

  1. 在应用商店安装"我的房子"应用
  2. 打开手机,点击"我的房子"图标
  3. 点击"进入我的房子"按钮
  4. 在房子维度中,点击"返回主世界"可以回到原来的位置

时间显示

手机状态栏显示Minecraft世界时间:

  • 格式: 12小时制 (例如: 3:30 PM)
  • 基于游戏内世界时间

更新日志

v1.1.0 (2025-05-28)

新增:

  • 16:9宽屏手机 - 手机GUI改为更现代的16:9比例
  • 电池系统 - 手机现在需要电量才能使用
    • 状态栏显示电量百分比
    • 各种操作会消耗电量(打开GUI、发送短信、拍照等)
    • 电量低时电池图标变红警告
  • 充电台 - 新方块,手持手机右键点击即可充电
  • 三大金刚键 - 底部导航栏包含返回、主页、多任务键
    • 在所有应用界面底部显示
    • 方便快速返回主界面
  • 全局状态栏 - 所有应用显示统一的状态栏
    • 信号强度、运营商、时间、电量
  • 相册系统 - 查看拍摄的照片
    • 真实图片显示,保持原始比例
    • 支持放大缩小(鼠标滚轮)
    • 支持删除照片
    • 2x3网格布局浏览
  • 手机商人村民 - 可交易手机相关物品
    • 5个交易等级,解锁更多交易
    • 交易手机、SIM卡、充电台、信号基站
    • 刷怪蛋和命令两种生成方式
  • 房子应用 - 进入私人房子维度
    • 单空岛设计,漂浮在空中的私人空间
    • 圆形空岛底座,泥土和石头结构
    • 完整的木质房子,包含门、窗户和屋顶
    • 房子内有火把
    • 床可以正常使用并设置重生点,不会爆炸
    • 独立维度,与主世界完全隔离
  • 应用网格改为4x4布局,每页显示16个应用
  • 状态栏全新设计 - 更现代化的UI风格
  • 信号强度可视化 - 4格竖条显示,不同强度不同颜色
  • 运营商名称显示 - 根据玩家名称自动分配运营商

改进:

  • 状态栏电池图标显示真实电量百分比
  • 电池颜色根据电量变化(绿/黄/红)
  • 重构GUI架构 - 所有应用继承统一的基础类
  • 优化应用布局 - 所有应用界面布局重新设计
  • 完善本地化 - 所有字符串支持中英文本地化

v1.0.1 (2025-02-11)

新增:

  • 应用图标支持PNG格式显示

修复:

  • 修复应用图标文字遮挡问题

如果需要查看之前的版本请访问:https://modrinth.com/mod/mphone/changelog

许可证

GNU General Public License v3.0 (GPL-3.0)


About

这是一个为Minecraft 1.12.2开发的智能手机模组。

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors