cargo-n64 - GitLite

KO | EN

gitlite — search

#javascript #hacktoberfest #llm #machine-learning #deep-learning #linux #nodejs #macos #windows #cli #kubernetes #security #mcp #openai

cargo-n64

(★ 169)

Make Nintendo 64 games in Rust! 🦀

파일 탐색기

최종 버전 다운로드 (.zip)

- - ci.yml
- - cargo-n64.rs
- - linker.ld
  - mips-nintendo64-none.fmt
- cargo.rs
- cli.rs
- elf.rs
- fs.rs
- header.rs
- ipl3.rs
- lib.rs
.gitignore
Cargo.lock
Cargo.toml
LICENSE
README.md
rust-toolchain

# 설치 가이드

1. 코드 내려받기

git clone https://github.com/rust-console/cargo-n64

깃허브에서 프로젝트 코드 전체를 내 컴퓨터로 내려받습니다.

cd cargo-n64

방금 내려받은 프로젝트 폴더 안으로 이동합니다.

2. 공식 설치 스크립트

쉬움 추천

사전 준비물

Rust (rustup) cargo 명령어를 쓰려면 Rust가 필요합니다.

cargo install --path .

이 명령어를 터미널에 그대로 입력해 실행하세요.

cargo install cargo-n64

crates.io에 배포된 패키지를 빌드해서 설치합니다. 레포를 직접 클론할 필요가 없습니다.

✅ 설치 후 새 터미널을 열고, 프로그램의 버전 확인 명령(예: --version)으로 정상 설치됐는지 확인하세요.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

3. Rust

보통

사전 준비물

Git GitHub에서 프로젝트 코드를 내려받으려면 필요합니다.
Rust (rustup) rustup으로 설치하면 cargo도 함께 설치됩니다.

cargo install --path .

이 명령어를 터미널에 그대로 입력해 실행하세요.

cargo install cargo-n64

crates.io에 배포된 패키지를 빌드해서 설치합니다. 레포를 직접 클론할 필요가 없습니다.

✅ cargo build가 에러 없이 끝나면 성공입니다. target/ 폴더에 실행 파일이 생성됩니다.

이 레포의 README에 적힌 실제 명령어를 그대로 가져왔습니다.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# `cargo-n64`

[![Build Status](https://travis-ci.org/rust-console/cargo-n64.svg?branch=master)](https://travis-ci.org/rust-console/cargo-n64)
[![Crates.io](https://img.shields.io/crates/v/cargo-n64)](https://crates.io/crates/cargo-n64)
[![unsafe forbidden](https://img.shields.io/badge/unsafe-forbidden-success.svg)](https://github.com/rust-secure-code/safety-dance/)

A `cargo` subcommand to build Nintendo 64 ROMs in Rust! 🦀

## Installation

Requires Rust nightly.

When built from source, `cargo` will automatically install the correct version of the nightly compiler, based on the `rust-toolchain` file. However you will still need to install the `rust-src` component separately. It is recommended that you explicitly install the dependencies with the same versions used in CI, as described below.

Install dependencies:

```bash
rustup toolchain install $(cat rust-toolchain)
rustup run $(cat rust-toolchain) -- rustup component add rust-src
```

Install `cargo-n64` from source:

```bash
cargo install --path .
```

Install `cargo-n64` from [crates.io](https://crates.io/):

```bash
cargo install cargo-n64
```

## What does it do?

Nintendo 64 ROMs are flat binaries, and each one is unique. There is no standard format for the binary beyond a simple 64-byte header and a \~4KB bootcode (aka Initial Program Loader 3/IPL3). Everything beyond the first 4KB boundary is MIPS code and whatever data it requires. This is unlike modern application or game development where an operating system has a standard binary format (like ELF, PE, or WASM). In fact, the N64 doesn't even have an operating system! The flat binary in the ROM *is* the operating system, for all intents and purposes.

This makes it challenging to get started with N64 development, in general. You first have to build an OS from scratch, or use a library like [`libdragon`](https://github.com/DragonMinded/libdragon) or [`libn64`](https://github.com/tj90241/n64chain/tree/master/libn64). Then you need a tool (or two, or three!) to convert the object files from the compiler toolchain into a flat binary, add the header and IPL3, and finally fix the IPL3 checksum. `cargo-n64` takes the place of the latter set of tools and plugs in nicely to the Rust/cargo ecosystem.

For copyright purposes, the IPL3 binary is not included in this package. Collecting a working IPL3 binary is left as an exercise for the reader. You will be required to provide the path to your IPL3 with the `--ipl3` command line argument, or extract it from an existing ROM with `--ipl3-from-rom`.

## Examples

The separate `rrt0` repo has some examples you can build with `cargo-n64`: https://github.com/rust-console/rrt0/tree/main/examples