Level-Up新手教程3大Trait让Laravel用户模型秒变游戏化引擎【免费下载链接】level-upLevel-Up is a Laravel package introducing gamification into your applications. Users earn experience points (XP) and levels through interactions, while also unlocking achievements. It promotes engagement, competition, and fun through its dynamic leaderboard feature. Customisable to fit your specific needs项目地址: https://gitcode.com/gh_mirrors/le/level-upLaravel游戏化开发从未如此简单。Level-Up是一个专为Laravel打造的免费开源游戏化扩展包只需在用户模型上挂载3个Trait就能快速获得经验值XP、等级、成就、连续签到和排行榜等完整功能。本教程面向新手将用最少的代码带你从零开始把普通的User模型变成一台高效的游戏化引擎让网站互动变得更有趣、更有粘性。什么是Level-Up它能给你的Laravel项目带来什么Level-UpGitHub加速计划 / le / level-up是一个开源的Laravel游戏化组件核心思想是给用户行为赋予价值。无论是发帖、评论、签到还是每日登录你都可以为这些行为设置经验值奖励用户攒够经验就会自动升级达成条件还能解锁成就徽章配合动态排行榜营造竞争氛围。它主要由以下几个部分组成功能模块作用对应Trait经验值与等级加/减/设置经验点自动升级GiveExperience成就系统颁发、撤销、进度型成就HasAchievements连续签到每日打卡、断签重置、冻结保护HasStreaks排行榜按经验值动态排名无需Trait直接调用新手第一步3分钟完成安装配置安装过程非常简单两条命令即可完成这也是新手最容易上手的地方。1. 使用 Composer 安装composer require cjmellor/level-up2. 发布迁移文件并执行php artisan vendor:publish --taglevel-up-migrations php artisan migrate迁移会自动创建experiences经验值、levels等级、achievements成就、streaks连续签到等数据表具体文件可在 database/migrations 目录中查看。3. 发布配置文件可选php artisan vendor:publish --taglevel-up-config发布后可修改默认等级上限、连续签到冻结时长等参数详细配置项见 config/level-up.php。核心Trait一GiveExperience——经验值与自动升级的完整方案这是整个游戏化系统的核心。在User模型中引入它use LevelUp\Experience\Concerns\GiveExperience; class User extends Authenticatable { use GiveExperience; }常用的加经验值方法方法作用示例addPoints()增加经验值$user-addPoints(50);deductPoints()扣减经验值$user-deductPoints(10);setPoints()直接设定经验值$user-setPoints(100);getPoints()查询当前经验值$user-getPoints();getLevel()查询当前等级$user-getLevel();nextLevelAt()还差多少经验升级$user-nextLevelAt();如何搭建等级体系使用包提供的Level::add()门面一次性创建等级阶梯Level::add( [level 1, next_level_experience null], [level 2, next_level_experience 100], [level 3, next_level_experience 250], );注意等级1的升级经验必须为null作为所有用户的起始等级。用户经验达到100自动升到2级达到250升到3级升级瞬间会触发UserLevelledUp事件方便你发送升级通知。进阶玩法经验倍数加成想搞周末双倍经验活动withMultiplierData()addPoints()组合拳即可$user-withMultiplierData([event_id 222])-addPoints(10);也可直接传倍数参数$user-addPoints(amount: 10, multiplier: 2);。源码见 src/Concerns/GiveExperience.php。核心Trait二HasAchievements——成就徽章激励用户持续活跃成就系统能让用户获得被认可的成就感。引入方式同样简单use LevelUp\Experience\Concerns\HasAchievements; class User extends Authenticatable { use HasAchievements; }颁发与撤销成就// 颁发成就 $user-grantAchievement($achievement); // 进度型成就如完成任务50% $user-grantAchievement(achievement: $achievement, progress: 50); // 撤销成就 $user-revokeAchievement($achievement);进度型成就与隐藏成就进度型成就用incrementAchievementProgress($achievement, 10)每次累加进度达到100%时自动触发AchievementAwarded事件。隐藏成就创建时设置is_secret true解锁前对用户不可见可用$user-secretAchievements查询。进度查询$user-achievementsWithSpecificProgress(25)可筛选进度达标的成就。成就相关源码见 src/Concerns/HasAchievements.php。核心Trait三HasStreaks——连续签到与冰冻保护机制连续签到是提升用户日活的神器。Level-Up 不仅支持签到计数还贴心地提供冰冻功能——允许用户偶尔请假而不中断连续天数。use LevelUp\Experience\Concerns\HasStreaks; class User extends Authenticatable { use HasStreaks; }快速上手连续签到// 记录一次签到同一活动每天只计一次 $user-recordStreak($activity); // 查询当前连续天数 $user-getCurrentStreakCount($activity); // 检查今天是否已签到 $user-hasStreakToday($activity);断签自动重置与冰冻保护自动断签若中间断了一天再签到连续计数会自动重置为1并触发StreakBroken事件。冰冻保护$user-freezeStreak($activity)默认冻结1天可在配置freeze_duration中调整冻结期间断签不会被重置$user-unfreezeStreak($activity)解除冻结。历史归档断签时旧的连续记录会存入StreakHistory表方便统计用户最长连续天数。源码见 src/Concerns/HasStreaks.php。彩蛋功能排行榜与审计让游戏化更完整除了三大TraitLevel-Up 还免费附赠两个实用功能 动态排行榜一行代码生成按经验值排序的用户榜单配合分页展示效果更佳use LevelUp\Experience\Facades\Leaderboard; Leaderboard::generate(); // 获取全部排行 Leaderboard::generate(paginate: true); // 分页排行实现逻辑见 src/Services/LeaderboardService.php。 经验审计在配置中开启audit.enabled后每次加减经验都会自动记录原因和类型方便运营排查问题查询方式$user-experienceHistory;新手常见问题与建议Q1三个Trait可以只用一个吗完全可以。它们相互独立只用GiveExperience也能跑通经验升级。Q2等级上限怎么设置默认上限100级可在.env中配置LEVEL_CAP、LEVEL_CAP_ENABLED等变量。Q3想本地研究源码可通过git clone https://gitcode.com/gh_mirrors/le/level-up拉取完整项目测试用例在 tests 目录中是学习的最佳范本。给新手的3条建议先用GiveExperience跑通经验值闭环再逐步叠加成就和签到。善用事件升级、达成成就、断签与消息通知、邮件联动提升用户体验。排行榜数据量大时记得分页避免性能问题。Level-Up 让 Laravel 游戏化开发的成本降到最低——挂载3个Trait、调用几个方法一个完整的积分、等级、成就、签到体系就诞生了。现在就动手试试给用户一个上瘾的理由吧【免费下载链接】level-upLevel-Up is a Laravel package introducing gamification into your applications. Users earn experience points (XP) and levels through interactions, while also unlocking achievements. It promotes engagement, competition, and fun through its dynamic leaderboard feature. Customisable to fit your specific needs项目地址: https://gitcode.com/gh_mirrors/le/level-up创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
