《万国觉醒》之游戏战报FreeMarker模板引擎实现

流子

已于 2023-08-29 18:02:15 修改

阅读量1.3k

点赞数 1

分类专栏：游戏脚本文章标签： freemarker

于 2021-06-09 10:39:44 首次发布

本文链接：https://blog.csdn.net/jiangguilong2000/article/details/117733389

版权

游戏脚本专栏收录该内容

5 篇文章 0 订阅

订阅专栏

这两天在玩《万国觉醒》，看了下战报，每一回合伤害，技能，buf明细都写的很详尽，如果自己去实现，该怎么做呢？
战报如下：
在这里插入图片描述
想想，只要有个记录战斗明细的对象+模板引擎，一整合，需要的结果就出来了，就拿接口很丰富的freemarker练手。
好，我们先来学习下这个模板引擎的基础知识。

一、FreeMarker 是什么？

FreeMarker 是一款模板引擎：即一种基于模板和要改变的数据，并用来生成输出文本(HTML网页，电子邮件，配置文件，源代码等)的通用工具。它不是面向最终用户的，而是一个Java类库，是一款程序员可以嵌入他们所开发产品的组件。

模板编写为FreeMarker Template Language (FTL)。它是简单的，专用的语言，不是像PHP那样成熟的编程语言。那就意味着要准备数据在真实编程语言中来显示，比如数据库查询和业务运算，之后模板显示已经准备好的数据。在模板中，你可以专注于如何展现数据，而在模板之外可以专注于要展示什么数据。

在这里插入图片描述

二、使用步骤

1.引入库

implementation group: 'org.freemarker', name: 'freemarker', version: '2.3.31';

2.使用

1.数字格式化(金额格式化)

${num?string('0.00')}
如果小数点后不足两位，用 0 代替

${num?string('#.##')}
如果小数点后多余两位，就只保留两位，否则输出实际值
输出为：1239765.46

${num?string(',###.00')}
输出为：1,239,765.46
整数部分每三位用 , 分割，并且保证小数点后保留两位，不足用 0 代替

${num?string(',###.##')}
输出为：1,239,765.46
整数部分每三位用 , 分割，并且小数点后多余两位就只保留两位，不足两位就取实际位数，可以不不包含小数点

${num?string('000.00')}
输出为：012.70
整数部分如果不足三位（000），前面用0补齐，否则取实际的整数位

${num?string('###.00')}
等价于
${num?string('#.00')}
输出为：12.70
整数取实际的位数

2.时间字段格式化

时间:${(startTime?string("MM/dd HH:mm"))!}-${(endTime?string("MM/dd HH:mm"))!}

生成后就展现如下：
时间:06/09/ 10:18-06/09/ 10:18

3.千分位去除

${total?c}

4.如何使用枚举
java 字段为 private PhaseEnum phase;

public enum PhaseEnum {
    /**
     * 未处理
     */
    UN_RESOLVED(0, "未处理"),
    /**
     * 处理中
     */
    PROCESSING(1, "处理中"),
    /**
     * 已处理
     */
    RESOLVED(2, "已处理"),
    /**
     * 忽略
     */
    OMIT(3, "忽略"),
    ;
    private final int id;
    private final String message;

    PhaseEnum(int id, String message) {
        this.id = id;

        this.message = message;
    }

    public int getId() {
        return id;
    }

    public String getMessage() {
        return message;
    }
}

使用

${phase.message}
<#if phase == "UN_RESOLVED">[领取]<#else>[查看]</#if>
${phase}

结果为:

未处理
[领取]
UN_RESOLVED

5.if else

<#if (winner?exists)>
	[${winner.mainHero.name}](${winner.total?c})的部队正高举武器,欢庆胜利！
<#else>
	双方均全军覆没！
</#if>

6.switch case
只能用字符串或者数字为值

7.基本运算

战斗结果:${(round.one.after-round.one.before)?c}

8.声明变量

<#assign name="张三"/>

9.比较大小

<#if (operation.one.loss>0)>	
</#if>

10.获取列表大小

${one.array?size}

如果加在if条件

<#if (one.array?size>0)>
    <#list one.array as buff>
${buff.desc}
    </#list>
<#elseif (one.array?size>10)>
//....
<#else>
无临时增益
</#if>

11.断字符串是否相等

<#if (appVersion=="0.0.0.0")>
</#if>

12.特殊字符用noparse转义
比如 < 符号

<#noparse><</#noparse>

如果程序运行在标准时区，如何让freemarker 显示东八区时区的时间
在文件头加上

<#setting time_zone="Asia/Shanghai">

13.转义字符有哪些？

转义序列	含义
\ "	引号 (u0022)
\ ’	单引号(又称为撇号) (u0027)
\ {	起始花括号：{
\ \	反斜杠 (u005C)
\n	换行符 (u000A)
\r	回车 (u000D)
\t	水平制表符(又称为tab) (u0009)
\b	退格 (u0008)
\f	换页 (u000C)
\l	小于号：<
\g	大于号：>
\a	&符：&
\xCode	字符的16进制 Unicode 码 (UCS 码)

14.字符串填充,适合用于建文本表格
left_pad,right_pad


id       |     command name                      |average size    |   max size         |  total size      |invoke time
--------------------------------------------------------------------------------------------------------------------------------
<#list array as command>
${command.code?c?right_pad(10)}${command.name?right_pad(40)}${command.avgSize?c?right_pad(20)} ${command.maxSize?c?right_pad(20)}${command.totalSize?c?right_pad(20)}${command.invokeTimes?c?right_pad(20)}
</#list>

获得的结果如下：

id       |     command name                      |average size    |   max size         |  total size      |invoke time
--------------------------------------------------------------------------------------------------------------------------------
6         EntityNtfMsg                            123                  918                 21913               178                 
120       Player_UpdateView_C2S                   41                   42                  1760                42                  
121       Player_UpdateView_S2C                   0                    0                   0                   42                  
42        Player_ChangeArmyAction_C2S             24                   24                  48                  2                   
43        Player_ChangeArmyAction_S2C             0                    0                   0                   2                   
126       Player_SearchWalkPath_C2S               20                   20                  40                  2                   
127       Player_SearchWalkPath_S2C               37                   52                  74                  2                   
7         Login_C2S_Msg                           44                   44                  44                  1                   
8         Login_S2C_Msg                           23                   23                  23                  1                   
11        KeepAlive_C2S_Msg                       0                    0                   0                   1                   
12        KeepAlive_S2C_Msg                       7                    7                   7                   1                   
32        Player_GetDebugCommandList_C2S          2                    2                   2                   1                   
33        Player_GetDebugCommandList_S2C          635                  635                 635                 1                   
55        Player_ChangeMap_S2C                    5                    5                   5                   1                   
150       Player_SearchMonster_C2S                2                    2                   2                   1                   
151       Player_SearchMonster_S2C                12                   12                  12                  1

15.对LocalDateTime 的支持

 implementation group: 'no.api.freemarker', name: 'freemarker-java8', version: '2.1.0';

添加对对于JDK8的支持配置类

Configuration config = new Configuration(Configuration.VERSION_2_3_31);
config.setObjectWrapper(new Java8ObjectWrapper(Configuration.VERSION_2_3_31));

使用

${startTime.format('yyyy-MM-dd HH:mm:ss')}

要对时区进行设置的话，就要做如下的处理:

<#setting time_zone="Asia/Shanghai">
**统计日期**:<font color='comment'>${startTime.toZonedDateTime(time_zone).format('yyyy-MM-dd HH:mm:ss')} - ${endTime.toZonedDateTime(time_zone).format('yyyy-MM-dd HH:mm:ss')} </font>

综合使用

战斗日志
时间:${(startTime?string("MM/dd HH:mm:ss"))!}-${(endTime?string("MM/dd HH:mm:ss"))!}
地点:X:${x?c} Y:${y?c}
战斗简介
${one.name}[${one.mainHero.name}]和${other.name}[${other.mainHero.name}]在野外发生了遭遇战！
我方阵容
${one.name} [${one.mainHero.name}]等级${one.mainHero.level} <#if (one.deputyHero?exists)>&[${one.deputyHero.name}]等级${one.deputyHero.level}</#if>兵力:${one.total?c}
<#if (one.array?size>0)>
    <#list one.array as buff>
${buff.desc}
    </#list>
<#else>
无临时增益
</#if>
敌方阵容
${other.name} [${other.mainHero.name}]等级${other.mainHero.level} <#if (other.deputyHero?exists)>&[${other.deputyHero.name}]等级${other.deputyHero.level}</#if>兵力:${other.total?c}
<#if (other.array?size>0)>
    <#list other.array as buff>
        ${buff.desc}
    </#list>
<#else>
无临时增益
</#if>
<#list array as round>
第${round.id}回合
    <#if (round.one?exists)&&(round.other?exists)>
[我方]兵力:${round.one.before?c}，战斗结果:${(round.one.after-round.one.before)?c}
[敌方]兵力:${round.other.before?c}，战斗结果:${(round.other.after-round.other.before)?c}
    <#list round.one.array as buff>
[${round.one.name}](${round.one.before?c})由于[${buff.name}]效果${buff.desc},${buff.message}
    </#list>
    <#list round.other.array as buff>
[${round.other.name}](${round.other.before?c})由于[${buff.name}]效果${buff.desc},${buff.message}
    </#list>
    <#list round.array as operation>
        <#if (operation.one?exists)>
            <#if (operation.one.skillVO?exists)>
[${operation.one.attacker.name}](${operation.one.total?c}) 发动了[${operation.one.skillVO.skillName}]!
                <#if (operation.one.loss>0)>
[${operation.one.defencer.name}]损失了${operation.one.loss?c}兵力
                </#if>
                <#list operation.one.skillVO.array as buff>
                    <#if (operation.one.id==buff.sourceId)>
[${operation.one.attacker.name}]的部队获得了${buff.name}效果加成,${buff.message}
                    <#else>
[${operation.one.defencer.name}]的部队获得了${buff.name}效果加成,${buff.message}
                    </#if>
                </#list>
            <#else>
                <#if (operation.one.loss>0)>
[${operation.one.attacker.name}](${operation.one.total?c})对[${operation.one.defencer.name}]发起了普通攻击，[${operation.one.defencer.name}]损失了${operation.one.loss?c}兵力
                </#if>
            </#if>
        </#if>
        <#if (operation.other?exists)>
            <#if (operation.other.loss>0)>
[${operation.other.attacker.name}]发动反击，[${operation.other.defencer.name}]损失了${operation.other.loss?c}兵力
            </#if>
        </#if>

    </#list>
    <#else>
本回合交战双方都没有发生战斗！
    </#if>
    ------------------------------------------------------------------------------
</#list>
战斗结束
<#switch endType.name()>
    <#case "BOT_END">
        <#if (winner?exists)>
[${winner.mainHero.name}](${winner.total?c})的部队正高举武器,欢庆胜利！
        <#else>
双方均全军覆没！
        </#if>
        <#break>
    <#case "BOT_OUT_OF_ROUND">
由于一方撤退，两军不再交战！
        <#break>
    <#case "BOT_OUT_OF_HIDDEN">
由于一方隐藏，两军不再交战！
        <#break>
    <#default>
战斗结束！
</#switch>

整合后的文字战报如下：

战斗日志
时间:06/10 11:51:44-06/10 11:52:35
地点:X:13478 Y:12852
战斗简介
玩家名[项羽]和玩家名[谭雅]在野外发生了遭遇战！
我方阵容
玩家名 [项羽]等级1 兵力:2294
敌方阵容
玩家名 [谭雅]等级1 兵力:7000

第1回合
[我方]兵力:2294，战斗结果:-48
[敌方]兵力:7000，战斗结果:-85
[项羽](2294)对[谭雅]发起了普通攻击，[谭雅]损失了42兵力
[谭雅]发动反击，[项羽]损失了24兵力

[谭雅](7000)对[项羽]发起了普通攻击，[项羽]损失了24兵力
[项羽]发动反击，[谭雅]损失了43兵力

    ------------------------------------------------------------------------------
第2回合
[我方]兵力:2246，战斗结果:-48
[敌方]兵力:6915，战斗结果:-86
[项羽](2246)对[谭雅]发起了普通攻击，[谭雅]损失了44兵力
[谭雅]发动反击，[项羽]损失了24兵力

[谭雅](6915)对[项羽]发起了普通攻击，[项羽]损失了24兵力
[项羽]发动反击，[谭雅]损失了42兵力

    ------------------------------------------------------------------------------
第3回合
[我方]兵力:2198，战斗结果:-48
[敌方]兵力:6829，战斗结果:-84
[项羽](2198)对[谭雅]发起了普通攻击，[谭雅]损失了42兵力
[谭雅]发动反击，[项羽]损失了24兵力

[谭雅](6829)对[项羽]发起了普通攻击，[项羽]损失了24兵力
[项羽]发动反击，[谭雅]损失了42兵力

    ------------------------------------------------------------------------------
第4回合
[我方]兵力:2150，战斗结果:-48
[敌方]兵力:6745，战斗结果:-84
[项羽](2150)对[谭雅]发起了普通攻击，[谭雅]损失了42兵力
[谭雅]发动反击，[项羽]损失了24兵力

[谭雅](6745)对[项羽]发起了普通攻击，[项羽]损失了24兵力
[项羽]发动反击，[谭雅]损失了42兵力

    ------------------------------------------------------------------------------
第5回合
[我方]兵力:2102，战斗结果:-48
[敌方]兵力:6661，战斗结果:-82
[项羽](2102)对[谭雅]发起了普通攻击，[谭雅]损失了42兵力
[谭雅]发动反击，[项羽]损失了24兵力

[谭雅](6661)对[项羽]发起了普通攻击，[项羽]损失了24兵力
[项羽]发动反击，[谭雅]损失了40兵力

    ------------------------------------------------------------------------------
第6回合
[我方]兵力:2054，战斗结果:-47
[敌方]兵力:6579，战斗结果:-83
[项羽](2054)对[谭雅]发起了普通攻击，[谭雅]损失了42兵力
[谭雅]发动反击，[项羽]损失了23兵力

[谭雅](6579)对[项羽]发起了普通攻击，[项羽]损失了24兵力
[项羽]发动反击，[谭雅]损失了41兵力

    ------------------------------------------------------------------------------
第7回合
[我方]兵力:2007，战斗结果:-47
[敌方]兵力:6496，战斗结果:-81
[项羽](2007)对[谭雅]发起了普通攻击，[谭雅]损失了40兵力
[谭雅]发动反击，[项羽]损失了23兵力

[谭雅](6496)对[项羽]发起了普通攻击，[项羽]损失了24兵力
[项羽]发动反击，[谭雅]损失了41兵力

    ------------------------------------------------------------------------------
第8回合
[我方]兵力:1960，战斗结果:-46
[敌方]兵力:6415，战斗结果:-81
[项羽](1960)对[谭雅]发起了普通攻击，[谭雅]损失了40兵力
[谭雅]发动反击，[项羽]损失了23兵力

[谭雅](6415)对[项羽]发起了普通攻击，[项羽]损失了23兵力
[项羽]发动反击，[谭雅]损失了41兵力

    ------------------------------------------------------------------------------
第9回合
[我方]兵力:1914，战斗结果:-47
[敌方]兵力:6334，战斗结果:-78
[项羽](1914)对[谭雅]发起了普通攻击，[谭雅]损失了39兵力
[谭雅]发动反击，[项羽]损失了24兵力

[谭雅](6334)对[项羽]发起了普通攻击，[项羽]损失了23兵力
[项羽]发动反击，[谭雅]损失了39兵力

    ------------------------------------------------------------------------------
第10回合
[我方]兵力:1867，战斗结果:-46
[敌方]兵力:6256，战斗结果:-79
[项羽](1867)对[谭雅]发起了普通攻击，[谭雅]损失了39兵力
[谭雅]发动反击，[项羽]损失了23兵力

[谭雅](6256)对[项羽]发起了普通攻击，[项羽]损失了23兵力
[项羽]发动反击，[谭雅]损失了40兵力

.....
.....
    ------------------------------------------------------------------------------
第52回合
[我方]兵力:18，战斗结果:-18
[敌方]兵力:3891，战斗结果:-3
[项羽](18)由于[万箭齐发]效果全军攻击力增强10%,剩余4回合
[谭雅](3891)由于[万箭齐发]效果全军攻击力增强10%,剩余4回合
[项羽](18)对[谭雅]发起了普通攻击，[谭雅]损失了3兵力
[谭雅]发动反击，[项羽]损失了18兵力

    ------------------------------------------------------------------------------
战斗结束
[谭雅](3888)的部队正高举武器,欢庆胜利！

总结

以上都是制作游戏战报的过程中的一些总结，大家也可以用其他模板引擎去做实现。

参考链接:
freemarker在线手册

流子

关注

1
点赞
踩
4

收藏

觉得还不错? 一键收藏
打赏
0
评论
《万国觉醒》之游戏战报FreeMarker模板引擎实现

这两天在玩《万国觉醒》，看了下战报，每一回合伤害，技能，buf明细都写的很详尽，如果自己去实现，该怎么做呢？想想，只要有个记录战斗明细的对象+模板引擎，一整合，需要的结果就出来了，就拿接口很丰富的freemarker练手。好，我们先来学习下这个模板引擎的基础知识。
复制链接

扫一扫