feat: 초기 커밋

- Progress Quest 6.4 Flutter 포팅 프로젝트
- 게임 루프, 상태 관리, UI 구현
- 캐릭터 생성, 인벤토리, 장비, 주문 시스템
- 시장/판매/구매 메커니즘
This commit is contained in:
JiWoong Sul
2025-12-09 17:24:04 +09:00
commit 08054d97c1
168 changed files with 12876 additions and 0 deletions

View File

@@ -0,0 +1,100 @@
import 'package:askiineverdie/src/core/engine/game_mutations.dart';
import 'package:askiineverdie/src/core/engine/progress_loop.dart';
import 'package:askiineverdie/src/core/engine/progress_service.dart';
import 'package:askiineverdie/src/core/engine/reward_service.dart';
import 'package:askiineverdie/src/core/model/game_state.dart';
import 'package:askiineverdie/src/core/model/pq_config.dart';
import 'package:askiineverdie/src/core/storage/save_manager.dart';
import 'package:askiineverdie/src/core/storage/save_repository.dart';
import 'package:askiineverdie/src/core/storage/save_service.dart';
import 'package:flutter_test/flutter_test.dart';
class _FakeSaveManager implements SaveManager {
final List<GameState> savedStates = [];
@override
Future<SaveOutcome> saveState(GameState state, {String? fileName}) async {
savedStates.add(state);
return const SaveOutcome.success();
}
@override
Future<(SaveOutcome, GameState?)> loadState({String? fileName}) async {
return (const SaveOutcome.success(), null);
}
@override
Future<List<SaveFileInfo>> listSaves() async => [];
}
void main() {
late ProgressService service;
setUp(() {
const config = PqConfig();
final mutations = GameMutations(config);
service = ProgressService(
config: config,
mutations: mutations,
rewards: RewardService(mutations),
);
});
test('autosaves on level-up and stop when configured', () async {
final saveManager = _FakeSaveManager();
final initial = GameState.withSeed(
seed: 123,
traits: const Traits(
name: 'LoopHero',
race: 'Orc',
klass: 'Warrior',
level: 1,
motto: '',
guild: '',
),
stats: const Stats(
str: 8,
con: 7,
dex: 6,
intelligence: 5,
wis: 4,
cha: 3,
hpMax: 9,
mpMax: 8,
),
progress: const ProgressState(
task: ProgressBarState(position: 1200, max: 1200),
quest: ProgressBarState(position: 0, max: 10),
plot: ProgressBarState(position: 0, max: 10),
exp: ProgressBarState(position: 3, max: 3),
encumbrance: ProgressBarState(position: 0, max: 0),
currentTask: TaskInfo(caption: 'Battle', type: TaskType.kill),
plotStageCount: 1,
questCount: 0,
),
);
final loop = ProgressLoop(
initialState: initial,
progressService: service,
saveManager: saveManager,
autoSaveConfig: const AutoSaveConfig(
onLevelUp: true,
onQuestComplete: true,
onActComplete: true,
onStop: true,
),
now: () => DateTime.fromMillisecondsSinceEpoch(0),
);
final updated = loop.tickOnce(deltaMillis: 50);
expect(saveManager.savedStates.length, 1);
expect(updated.traits.level, 2);
await loop.stop(saveOnStop: true);
expect(saveManager.savedStates.length, 2);
expect(saveManager.savedStates.last, same(updated));
});
}

View File

@@ -0,0 +1,158 @@
import 'package:askiineverdie/src/core/engine/game_mutations.dart';
import 'package:askiineverdie/src/core/engine/progress_service.dart';
import 'package:askiineverdie/src/core/engine/reward_service.dart';
import 'package:askiineverdie/src/core/model/game_state.dart';
import 'package:askiineverdie/src/core/model/pq_config.dart';
import 'package:askiineverdie/src/core/util/pq_logic.dart' as pq_logic;
import 'package:flutter_test/flutter_test.dart';
void main() {
late ProgressService service;
late PqConfig config;
setUp(() {
config = const PqConfig();
final mutations = GameMutations(config);
service = ProgressService(
config: config,
mutations: mutations,
rewards: RewardService(mutations),
);
});
test('tick advances task bar and recalculates encumbrance', () {
final state = GameState.withSeed(
seed: 42,
stats: const Stats(
str: 5,
con: 0,
dex: 0,
intelligence: 0,
wis: 0,
cha: 0,
hpMax: 0,
mpMax: 0,
),
inventory: const Inventory(
gold: 5,
items: [
InventoryEntry(name: 'Rock', count: 3),
],
),
progress: const ProgressState(
task: ProgressBarState(position: 0, max: 80),
quest: ProgressBarState(position: 0, max: 10),
plot: ProgressBarState(position: 0, max: 10),
exp: ProgressBarState(position: 0, max: 50),
encumbrance: ProgressBarState(position: 0, max: 0),
currentTask: TaskInfo(caption: 'Test', type: TaskType.kill),
plotStageCount: 1,
questCount: 0,
),
);
final result = service.tick(state, 150);
expect(result.leveledUp, isFalse);
expect(result.completedQuest, isFalse);
expect(result.completedAct, isFalse);
expect(result.state.progress.task.position, 80);
expect(result.state.progress.task.max, 80);
expect(result.state.progress.encumbrance.position, 3);
expect(result.state.progress.encumbrance.max, 15);
expect(result.state.progress.currentTask.caption, 'Test');
});
test('tick levels up when EXP is full during kill task', () {
final initial = GameState.withSeed(
seed: 7,
traits: const Traits(
name: 'Hero',
race: 'Human',
klass: 'Fighter',
level: 1,
motto: '',
guild: '',
),
stats: const Stats(
str: 10,
con: 9,
dex: 8,
intelligence: 7,
wis: 6,
cha: 5,
hpMax: 10,
mpMax: 11,
),
progress: const ProgressState(
task: ProgressBarState(position: 1000, max: 1000),
quest: ProgressBarState(position: 0, max: 10),
plot: ProgressBarState(position: 0, max: 10),
exp: ProgressBarState(position: 5, max: 5),
encumbrance: ProgressBarState(position: 0, max: 0),
currentTask: TaskInfo(caption: 'Battle', type: TaskType.kill),
plotStageCount: 1,
questCount: 0,
),
);
final result = service.tick(initial, 50);
expect(result.leveledUp, isTrue);
expect(result.shouldAutosave, isTrue);
expect(result.state.traits.level, 2);
expect(result.state.stats.hpMax, greaterThan(initial.stats.hpMax));
expect(result.state.stats.mpMax, greaterThan(initial.stats.mpMax));
expect(result.state.progress.exp.position, 0);
expect(result.state.progress.exp.max, pq_logic.levelUpTime(2));
// 태스크 완료 후 새 태스크가 자동으로 시작됨
expect(result.state.progress.task.position, 0);
expect(result.state.progress.task.max, greaterThan(0));
});
test('quest completion enqueues next task and resets quest bar', () {
final initial = GameState.withSeed(
seed: 99,
traits: const Traits(
name: 'Questor',
race: 'Elf',
klass: 'Mage',
level: 3,
motto: '',
guild: '',
),
stats: const Stats(
str: 4,
con: 5,
dex: 6,
intelligence: 7,
wis: 8,
cha: 9,
hpMax: 12,
mpMax: 10,
),
progress: const ProgressState(
task: ProgressBarState(position: 2000, max: 2000),
quest: ProgressBarState(position: 4, max: 5),
plot: ProgressBarState(position: 0, max: 20),
exp: ProgressBarState(position: 0, max: 30),
encumbrance: ProgressBarState(position: 0, max: 0),
currentTask: TaskInfo(caption: 'Hunt', type: TaskType.kill),
plotStageCount: 2,
questCount: 1,
),
queue: QueueState(entries: const []),
);
final result = service.tick(initial, 50);
final nextState = result.state;
expect(result.completedQuest, isTrue);
expect(nextState.progress.questCount, 2);
expect(nextState.progress.quest.position, 0);
expect(nextState.progress.quest.max, inInclusiveRange(50, 149));
expect(nextState.progress.currentTask.type, TaskType.neutral);
expect(nextState.progress.task.position, 0);
expect(nextState.queue.entries, isEmpty);
});
}

View File

@@ -0,0 +1,245 @@
import 'package:askiineverdie/src/core/model/equipment_slot.dart';
import 'package:askiineverdie/src/core/model/game_state.dart';
import 'package:askiineverdie/src/core/model/pq_config.dart';
import 'package:askiineverdie/src/core/util/deterministic_random.dart';
import 'package:askiineverdie/src/core/util/pq_logic.dart' as pq_logic;
import 'package:flutter_test/flutter_test.dart';
void main() {
const config = PqConfig();
test('levelUpTime grows with level and matches expected seconds', () {
expect(pq_logic.levelUpTime(1), 1269);
expect(pq_logic.levelUpTime(10), 1443);
});
test('roughTime formats seconds into human-readable strings', () {
// < 120초: seconds
expect(pq_logic.roughTime(60), '60 seconds');
expect(pq_logic.roughTime(119), '119 seconds');
// 120초 ~ 2시간: minutes
expect(pq_logic.roughTime(120), '2 minutes');
expect(pq_logic.roughTime(3600), '60 minutes');
expect(pq_logic.roughTime(7199), '119 minutes');
// 2시간 ~ 48시간: hours
expect(pq_logic.roughTime(7200), '2 hours');
expect(pq_logic.roughTime(86400), '24 hours');
expect(pq_logic.roughTime(172799), '47 hours');
// 48시간 이상: days
expect(pq_logic.roughTime(172800), '2 days');
expect(pq_logic.roughTime(604800), '7 days');
});
test('generateName produces deterministic names per seed', () {
expect(pq_logic.generateName(DeterministicRandom(123)), 'Grunax');
expect(pq_logic.generateName(DeterministicRandom(42)), 'Bregpran');
});
test('indefinite/definite/pluralize honor English rules', () {
expect(pq_logic.indefinite('apple', 1), 'an apple');
expect(pq_logic.indefinite('orc', 3), '3 orcs');
expect(pq_logic.definite('goblin', 2), 'the goblins');
expect(pq_logic.pluralize('baby'), 'babies');
});
test('item and reward helpers are deterministic with seed', () {
expect(pq_logic.boringItem(config, DeterministicRandom(12)), 'egg');
expect(
pq_logic.interestingItem(config, DeterministicRandom(12)),
'Golden Ornament',
);
expect(
pq_logic.specialItem(config, DeterministicRandom(12)),
'Golden Ornament of Efficiency',
);
// 원본 Main.pas:770-774 RandomLow 방식으로 수정됨
expect(
pq_logic.winSpell(config, DeterministicRandom(22), 7, 4),
'Slime Finger|II',
);
expect(
pq_logic.winEquip(
config,
DeterministicRandom(12),
5,
EquipmentSlot.weapon,
),
'Baselard',
);
expect(
pq_logic.winEquip(
config,
DeterministicRandom(15),
2,
EquipmentSlot.armor,
),
'-2 Canvas',
);
expect(
pq_logic.winItem(config, DeterministicRandom(10), 3),
'Golden Hymnal of Cruelty',
);
expect(pq_logic.winItem(config, DeterministicRandom(10), 1000), isEmpty);
});
test('monsterTask picks level-appropriate monsters with modifiers', () {
expect(
pq_logic.monsterTask(config, DeterministicRandom(99), 5, null, null),
'an underage Rakshasa',
);
expect(
pq_logic.monsterTask(config, DeterministicRandom(7), 10, null, null),
'a greater Sphinx',
);
expect(
pq_logic.monsterTask(config, DeterministicRandom(5), 6, 'Goblin|3', 3),
'a Barbed Devil',
);
});
test('completeQuest and completeAct return deterministic results', () {
final quest = pq_logic.completeQuest(config, DeterministicRandom(33), 4);
expect(quest.caption, 'Deliver this chicken');
expect(quest.reward, pq_logic.RewardKind.item);
expect(quest.monsterName, isNull);
final act2 = pq_logic.completeAct(2);
expect(act2.actTitle, 'Act II');
expect(act2.plotBarMaxSeconds, 39600);
expect(act2.rewards, contains(pq_logic.RewardKind.item));
expect(act2.rewards, isNot(contains(pq_logic.RewardKind.equip)));
final act3 = pq_logic.completeAct(3);
expect(
act3.rewards,
containsAll(<pq_logic.RewardKind>{
pq_logic.RewardKind.item,
pq_logic.RewardKind.equip,
}),
);
});
test('dequeue starts next task and drains queue', () {
const progress = ProgressState(
task: ProgressBarState(position: 100, max: 100),
quest: ProgressBarState(position: 0, max: 10),
plot: ProgressBarState(position: 0, max: 10),
exp: ProgressBarState(position: 0, max: 10),
encumbrance: ProgressBarState(position: 0, max: 1),
currentTask: TaskInfo(caption: 'Idle', type: TaskType.neutral),
plotStageCount: 1,
questCount: 0,
);
final queue = QueueState(
entries: const [
QueueEntry(
kind: QueueKind.task,
durationMillis: 120,
caption: 'Fight',
taskType: TaskType.kill,
),
QueueEntry(
kind: QueueKind.plot,
durationMillis: 80,
caption: 'Plot',
taskType: TaskType.plot,
),
],
);
final result = pq_logic.dequeue(progress, queue);
expect(result, isNotNull);
expect(result!.caption, 'Fight...');
expect(result.taskType, TaskType.kill);
expect(result.kind, QueueKind.task);
expect(result.progress.task.position, 0);
expect(result.progress.task.max, 120);
expect(result.queue.entries.length, 1);
expect(result.queue.entries.first.kind, QueueKind.plot);
});
test('impressiveGuy generates deterministic NPC titles', () {
// case 0: "the King of the Elves" 형태
final guy1 = pq_logic.impressiveGuy(config, DeterministicRandom(42));
expect(guy1, contains('of the'));
// case 1: "King Vrognak of Zoxzik" 형태
final guy2 = pq_logic.impressiveGuy(config, DeterministicRandom(7));
expect(guy2, contains(' of '));
// 결정적(deterministic) 결과 확인
expect(
pq_logic.impressiveGuy(config, DeterministicRandom(100)),
pq_logic.impressiveGuy(config, DeterministicRandom(100)),
);
});
test('namedMonster generates named monster with level matching', () {
final monster = pq_logic.namedMonster(config, DeterministicRandom(42), 10);
// "GeneratedName the MonsterType" 형태
expect(monster, contains(' the '));
// 결정적(deterministic) 결과 확인
expect(
pq_logic.namedMonster(config, DeterministicRandom(50), 5),
pq_logic.namedMonster(config, DeterministicRandom(50), 5),
);
});
test('interplotCinematic generates queue entries with plot ending', () {
final entries = pq_logic.interplotCinematic(
config,
DeterministicRandom(42),
10,
3,
);
// 최소 1개 이상의 엔트리 생성
expect(entries, isNotEmpty);
// 마지막은 항상 plot 타입의 'Loading'
expect(entries.last.kind, QueueKind.plot);
expect(entries.last.caption, 'Loading');
expect(entries.last.durationMillis, 2000);
// 나머지는 task 타입
for (var i = 0; i < entries.length - 1; i++) {
expect(entries[i].kind, QueueKind.task);
}
});
test('interplotCinematic has three distinct scenarios', () {
// 여러 시드를 테스트해서 3가지 시나리오가 모두 나오는지 확인
final scenariosFound = <String>{};
for (var seed = 0; seed < 100; seed++) {
final entries = pq_logic.interplotCinematic(
config,
DeterministicRandom(seed),
5,
1,
);
final firstCaption = entries.first.caption;
if (firstCaption.contains('oasis')) {
scenariosFound.add('oasis');
// 오아시스 시나리오: 4개 task + 1개 plot = 5개
expect(entries.length, 5);
} else if (firstCaption.contains('quarry')) {
scenariosFound.add('combat');
// 전투 시나리오: 가변 길이 (combatRounds에 따라)
expect(entries.length, greaterThanOrEqualTo(5));
} else if (firstCaption.contains('sweet relief')) {
scenariosFound.add('betrayal');
// 배신 시나리오: 6개 task + 1개 plot = 7개
expect(entries.length, 7);
}
}
// 3가지 시나리오가 모두 발견되어야 함
expect(scenariosFound, containsAll(['oasis', 'combat', 'betrayal']));
});
}