# ZMapLib

**Repository Path**: whksoft/my-map

## Basic Information

- **Project Name**: ZMapLib
- **Description**: No description available
- **Primary Language**: Java
- **License**: WTFPL
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2021-01-26
- **Last Updated**: 2021-05-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

本模块就是用来给Zpay提供扫码地图的设计思路，基于Bukkit。

本插件已停更

## 具体适配环境：
适配的Minecraft版本:`1.8.9 1.12.x 1.13.x 1.14.x 1.15.x 1.16.x`(不会吧不会吧，竟然真有人用1.10 1.11开服？)
    
已经过测试的版本：`1.13, 1.14, 1.15, 1.16`

支持的服务器核心：看下面！！！

已通过测试的服务端： Bukkit Spigot Paper Yatopia ~~（计划对模组服引入VexView）~~

未通过测试的服务端： 
>Mohist(引用Bukkit的某个API时会导致空指针异常，并且有的时候会导致找不到主类，我们近期将会提出issue)
> 
>Magma(空指针，不显示错误日志)
> 
>Arclight(具体什么原因不用我多说了吧)

## 使用方法：
`/map 文本`         用来生成一个128*128的二维码 用地图形式表示，由于是临时地图，所以加了不少检测机制。

`/map URL`         ~~生成一个展示图片的二维码（WIP）~~

注意：命令功能将会被移除

##API

###事件
`PaymentCanceledEvent`    玩家取消支付事件 

`MapClearedEvent`           地图被清空事件

用法:

    @EventHandler(priority = EventPriority.HIGHEST)
    public void example(PaymentCanceledEvent e){
        //需要执行的语句
    }

说明:

本事件仅适用于将**收款二维码**或者**扫码登录二维码**放入地图中使用

###方法
有一个工具类`ZMapManager`与`ZMap`对象

`ZMap zmap = new ZMap(BufferedImage image)`根据图片生成扫码地图，大小不得超过128x128

`ZMap zmap = new ZMap(String text)`根据文本生成扫码地图

    zmap.setHideEnchantMent(true) 设置隐藏附魔为真
    zmap.setEnchantMent(ENCHANTMENT.KNOCKBACK) 设置附魔为击退
    zmap.setName(String name) 设置扫码地图在mc里的名字
    zmap.setLore(List<String> lore) 设置扫码地图的备注

`ZMapManager.give(ZMap zMap, Player p)`给予一个玩家扫码地图

`ZMapManager.clear(Player p)`清除该玩家的扫码地图