Time Loan
- By
Borrow items from your future self — repay before the deadline, or trigger a paradox.
# ⌛ Time Loan
**Borrow items from your future self. Pay them back before the deadline — or watch everything you built with them vanish in a paradox.**
> 🇰🇷 한국어 설명은 아래에 있습니다.
Time Loan adds a **Time Vault** that lets you take items you haven't earned yet. Grab a diamond pickaxe on day one and race ahead. But the loan is a loop that has to close: before the deadline you must obtain the same item **yourself** and put it in the vault, so it becomes "the thing you sent back to your past self."
Fail, and the paradox collapses. The borrowed pickaxe disappears, along with **every ore you mined with it and every tool you crafted from those ores.**
Unlike other "time debt" mods, this is not about sleeping or skipping nights. It's a **loan system** with real risk/reward: borrow big and snowball fast, or play it safe.
---
## 🔄 How it works
1. **Craft a Time Vault**: 8 cobblestone around a torch. You can make it on day one.
2. **Right-click it with an empty hand.** A clickable chat menu shows what you can borrow. Click an item and your future self sends it to you.
3. **Everything derived from a loan is linked to it.** Ores mined with a borrowed tool, mob drops from a borrowed weapon, and items crafted, stonecut or smelted from linked materials all carry the loan's mark. Hover over any item to see it.
4. **Repay before the deadline.** Hold a *clean* copy of the item and right-click the vault. Items linked to the same loan can't repay it, so you can't pay back the pickaxe with a pickaxe made from diamonds it mined.
5. **Loop closed!** All marks are removed and everything becomes truly yours.
## ⚡ The Paradox
What happens when you miss the deadline is configurable:
| Mode | When the deadline passes |
|---|---|
| **CASCADE** | Instant collapse. Every linked item vanishes: inventory, ender chest, dropped items, and chests the moment they're opened. |
| **COLLECTOR** | **Time Collectors**, glowing, wall-phasing spectres, hunt you down. If they catch you, they seize the linked items you're carrying. |
| **BOTH** *(default)* | Collectors hunt you for one day while you can still repay at 2× the amount. After that, total collapse. |
The deadline counts **real server time**. Sleeping or `/time set` won't buy you extra days.
## 🤝 Multiplayer
- **Guarantor**: Ask a friend to co-sign your loan. You get +2 days, and they can repay on your behalf. If you default, the collectors come for them too.
- **Debt transfer**: Pass your loan to another player, if they accept. The items don't follow. Negotiate wisely.
## ✨ Quality of life
- The Time Vault appears in the recipe book automatically
- One-click borrowing from the vault menu, plus a ✎ button for a custom amount and duration
- Action-bar countdown when a loan is within a day of its deadline
- "Ready to repay ✔" indicator when you're holding enough clean items
- A 30-second cancel window if you borrowed by mistake
- First-join guide
## 📜 Commands
```
/timeloan status + help
/timeloan borrow <item> [count] [days]
/timeloan repay <id>
/timeloan cancel <id>
/timeloan list | catalog
/timeloan guarantee <id> <player>
/timeloan transfer <id> <player>
/timeloan accept | deny
/timeloan admin list | forgive | expire | paradox | reload (OP)
```
## ⚙️ Configuration
`config/timeloan.json`. Reload in-game with `/timeloan admin reload`.
You can change the paradox mode, loan terms (1–7 days), the borrowable item list and amounts, the max open loans per player, late repayment multiplier, collector mob type, health, damage and count, guarantee bonus, exempt items, and more.
## 📦 Requirements
- Minecraft **26.3**
- Fabric Loader **0.19+**
- **Fabric API**
- Required on **both client and server**
## 🌐 Languages
English, 한국어 — follows each player's game language, even on the same server. Translations welcome: just add a file to `assets/timeloan/lang/`.
---
---
# ⌛ 시간 대출 (Time Loan)
**미래의 나에게서 아이템을 빌려 쓰세요. 기한 안에 갚지 못하면, 그걸로 만든 모든 것이 패러독스와 함께 사라집니다.**
**시간 금고**에서 아직 얻지 못한 아이템을 미리 꺼내 쓸 수 있습니다. 첫날 다이아 곡괭이를 빌려 빠르게 성장해 보세요. 단, 기한 안에 같은 아이템을 **직접** 구해 금고에 넣어야 "과거의 나에게 보낸 것"이 되어 시간의 고리가 닫힙니다.
못 갚으면 패러독스가 터집니다. 빌린 곡괭이는 물론이고, **그 곡괭이로 캔 광물과 그 광물로 만든 장비까지** 연쇄적으로 사라집니다.
잠으로 밤을 넘길 때 페널티가 쌓이는 모드와는 전혀 다릅니다. **진짜 대출 구조**입니다. 초반에 크게 빌려 빠르게 성장할지, 안전하게 갈지 선택하세요.
---
## 🔄 플레이 방법
1. **시간 금고 제작**: 조약돌 8개로 횃불 1개를 둘러싸면 됩니다. 첫날부터 만들 수 있습니다.
2. **빈손으로 우클릭**하면 채팅창에 빌릴 수 있는 목록이 버튼으로 나옵니다. 원하는 아이템을 누르면 미래의 내가 보내 줍니다.
3. **빌린 물건에서 나온 모든 것에 꼬리표가 붙습니다.** 빌린 도구로 캔 광물, 빌린 무기로 잡은 몹의 드롭, 꼬리표 붙은 재료로 만들거나 자르거나 구운 물건이 모두 해당합니다. 아이템에 마우스를 올리면 확인할 수 있습니다.
4. **기한 안에 갚기**: 꼬리표 없는 같은 아이템을 들고 금고를 우클릭하세요. 같은 대출에서 나온 물건으로는 갚을 수 없습니다. 빌린 곡괭이로 캔 다이아로 만든 곡괭이로는 못 갚습니다.
5. **고리가 닫힙니다!** 모든 꼬리표가 사라지고 전부 온전히 내 것이 됩니다.
## ⚡ 패러독스
기한을 넘겼을 때의 처벌은 설정에서 고를 수 있습니다.
| 모드 | 기한이 지나면 |
|---|---|
| **CASCADE** | 즉시 연쇄 소멸. 인벤토리, 엔더 상자, 땅에 떨어진 아이템, 상자 속 물건(여는 순간)까지 모두 사라집니다. |
| **COLLECTOR** | 벽을 통과하는 빛나는 **시간 추심자**가 쫓아옵니다. 붙잡히면 들고 있던 대출품을 압류당합니다. |
| **BOTH** *(기본)* | 하루 동안 추심자에게 쫓기며 2배로 늦게 갚을 수 있습니다. 그래도 못 갚으면 연쇄 소멸합니다. |
기한은 **서버가 실제로 흐른 시간** 기준입니다. 잠이나 `/time set`으로는 시간을 벌 수 없습니다.
## 🤝 멀티플레이
- **보증**: 친구에게 보증을 부탁하면 기한이 2일 늘어나고, 친구가 대신 갚을 수도 있습니다. 하지만 연체되면 추심자는 보증인도 쫓아갑니다.
- **빚 떠넘기기**: 상대가 수락하면 대출을 다른 플레이어에게 넘길 수 있습니다. 물건은 따라가지 않으니 거래는 알아서 하세요.
## ✨ 편의 기능
- 레시피 책에 시간 금고 자동 등록
- 금고 메뉴에서 클릭 한 번으로 빌리기, ✎ 버튼으로 수량·기간 직접 설정
- 기한이 하루 이하로 남으면 화면 하단에 카운트다운 표시
- 갚을 물건이 준비되면 "갚을 준비 완료 ✔" 표시
- 실수로 빌렸을 때 30초 안에 취소 가능
- 처음 접속하면 사용법 안내
## 📜 명령어
```
/timeloan 현황 + 도움말
/timeloan borrow <아이템> [수량] [일수]
/timeloan repay <번호>
/timeloan cancel <번호>
/timeloan list | catalog
/timeloan guarantee <번호> <플레이어>
/timeloan transfer <번호> <플레이어>
/timeloan accept | deny
/timeloan admin list | forgive | expire | paradox | reload (OP)
```
## ⚙️ 설정
`config/timeloan.json` 파일을 수정한 뒤 게임 안에서 `/timeloan admin reload`로 적용합니다.
패러독스 모드, 대출 기간(1~7일), 빌릴 수 있는 아이템과 수량, 1인당 대출 한도, 연체 배율, 추심자 종류·체력·공격력·수, 보증 혜택, 꼬리표가 붙지 않는 아이템 등을 바꿀 수 있습니다.
## 📦 필요한 것
- Minecraft **26.3**
- Fabric Loader **0.19 이상**
- **Fabric API**
- **클라이언트와 서버 모두** 설치 필요
## 🌐 언어
English, 한국어 — 각 플레이어의 게임 언어 설정을 따릅니다. 같은 서버에서도 각자 자기 언어로 보입니다.
Time Loan Team
